اندیکاتور «Flag & Pole Pattern Tp-sl [JPT]» یک ابزار تحلیل تکنیکال در Pine Script نسخه ۶ است که برای شناسایی الگوهای کلاسیک «پرچم و میله» (Flag & Pole) طراحی شده است. این الگو یکی از محبوب‌ترین الگوهای ادامه‌دهنده روند در تحلیل تکنیکال محسوب می‌شود که در آن یک حرکت قیمتی قوی (میله یا Pole) شکل می‌گیرد و پس از آن یک دوره تثبیت کوتاه به شکل پرچم (Flag) ایجاد می‌شود. هدف اصلی این اندیکاتور، شناسایی خودکار این الگوها، رسم خطوط روند مربوط به پرچم، و ارائه سیگنال‌های خرید و فروش در نقطه شکست (Breakout) است. این اندیکاتور بر روی چارت قیمت overlay می‌شود و قادر است هم پرچم‌های صعودی و هم نزولی را تشخیص دهد.

این اندیکاتور از سه گروه اصلی تنظیمات ورودی تشکیل شده است: «Pole Detection»، «Flag Detection» و «Display Settings». در بخش تشخیص میله، کاربر می‌تواند طول بازنگری (Pole Lookback) را بین ۵ تا ۱۰۰ کندل تنظیم کند و حداقل اندازه میله را بر حسب ضریب ATR (پیش‌فرض ۳.۰) تعیین نماید. در بخش تشخیص پرچم، پارامترهایی مانند طول پیوت (Pivot Length)، درصد تحمل لمس (Touch Tolerance)، حداکثر طول پرچم (Maximum Flag Length) و حداقل شیب خط روند (Minimum Trendline Slope) قابل تنظیم هستند. بخش نمایش نیز به کاربر اجازه می‌دهد تا نمایش برچسب‌های میله، خطوط روند پرچم، سیگنال‌های خرید/فروش و برچسب‌های شکست را به دلخواه فعال یا غیرفعال کند. این انعطاف‌پذیری باعث می‌شود اندیکاتور برای تایم‌فریم‌ها و سبک‌های معاملاتی مختلف مناسب باشد.

اندیکاتور ابتدا با استفاده از ATR و مقایسه قیمت فعلی با قیمت در ابتدای دوره بازنگری، میله‌های صعودی و نزولی را شناسایی می‌کند. یک میله صعودی زمانی تأیید می‌شود که حرکت قیمت در طول دوره بازنگری حداقل به اندازه ضریب ATR تعیین‌شده باشد. سپس اندیکاتور سه سقف پیوت و سه کف پیوت آخر را ذخیره کرده و ساختار پرچم را بر اساس ترتیب نزولی یا صعودی این پیوت‌ها بررسی می‌کند. برای پرچم صعودی، سقف‌ها و کف‌ها باید نزولی باشند (شیب منفی) و برای پرچم نزولی، صعودی باشند. همچنین بررسی می‌شود که شیب خط روند از حداقل مقدار تعیین‌شده کمتر نباشد تا از تشخیص الگوهای کم‌شیب و بی‌اعتبار جلوگیری شود.

پس از تأیید ساختار، اندیکاتور وضعیت پرچم صعودی یا نزولی را فعال کرده و خطوط روند مقاومت و حمایت را با استفاده از پیوت‌های تأییدشده رسم می‌کند. این خطوط به صورت خط‌چین (Dashed) و با رنگ‌های متمایز (سبز/آبی برای صعودی و نارنجی/قرمز برای نزولی) ترسیم می‌شوند و به سمت راست ادامه می‌یابند. اندیکاتور همچنین قیمت projected این خطوط روند را در هر کندل محاسبه می‌کند تا امکان مقایسه قیمت فعلی با مرزهای پرچم فراهم شود. اگر پرچم از حداکثر طول تعیین‌شده (Maximum Flag Length) فراتر رود، وضعیت پرچم منقضی شده و خطوط روند دیگر ادامه نمی‌یابند. این مکانیزم باعث می‌شود تنها پرچم‌های معتبر و به‌روز در تحلیل لحاظ شوند.

سیگنال خرید زمانی صادر می‌شود که قیمت با یک کندل تأییدشده بالای خط مقاومت پرچم صعودی بسته شود و کندل قبلی زیر آن خط بوده باشد. به طور مشابه، سیگنال فروش زمانی فعال می‌شود که قیمت زیر خط حمایت پرچم نزولی بسته شود. پس از صدور سیگنال، وضعیت پرچم غیرفعال شده و خطوط روند متوقف می‌شوند. اندیکاتور سیگنال‌ها را با مثلث‌های سبز و قرمز روی چارت نمایش می‌دهد و برچسب‌های متنی «FLAG BREAKOUT BUY» و «FLAG BREAKDOWN SELL» را نیز اضافه می‌کند. چهار هشدار (Alert) مجزا برای تشخیص پرچم صعودی، پرچم نزولی، شکست صعودی و شکست نزولی تعریف شده است که کاربر می‌تواند در TradingView فعال کند. به طور کلی، این اندیکاتور ابزاری کامل برای معامله‌گران روند‌محور است که به دنبال نقاط ورود کم‌ریسک در ادامه روندهای قوی هستند.

تنظیمات اندیکاتور Flag & Pole Pattern TP SL

Pole Lookback — این تنظیم طول دوره بازنگری برای تشخیص میله (Pole) را تعیین می‌کند و مقدار پیش‌فرض آن ۲۰ کندل است؛ با افزایش این مقدار، میله‌های بلندمدت‌تر و با کاهش آن، میله‌های کوتاه‌مدت‌تر شناسایی می‌شوند و بازه مجاز آن بین ۵ تا ۱۰۰ کندل قابل تنظیم است. مقادیر کوچک‌تر برای تایم‌فریم‌های پایین و معاملات کوتاه‌مدت مناسب‌ترند، در حالی که مقادیر بزرگ‌تر برای تایم‌فریم‌های بالا و شناسایی روندهای بزرگ‌تر کاربرد دارند و انتخاب نادرست آن می‌تواند منجر به تشخیص میله‌های ناقص یا از دست دادن میله‌های واقعی شود. توصیه می‌شود این مقدار با سبک معاملاتی و تایم‌فریم مورد استفاده هماهنگ باشد تا دقت تشخیص الگو افزایش یابد.

Minimum Pole Size (ATR) — این تنظیم حداقل اندازه میله را بر حسب ضریب ATR مشخص می‌کند و مقدار پیش‌فرض آن ۳.۰ است؛ به این معنا که حرکت قیمت در طول دوره بازنگری باید حداقل سه برابر ATR باشد تا به عنوان میله معتبر شناخته شود. افزایش این مقدار باعث سخت‌گیرانه‌تر شدن تشخیص و فیلتر کردن میله‌های ضعیف می‌شود، در حالی که کاهش آن تعداد میله‌های شناسایی‌شده را بیشتر کرده اما ممکن است سیگنال‌های کم‌اعتبار ایجاد کند. این پارامتر باید با نوسان‌پذیری بازار تنظیم شود؛ در بازارهای پرنوسان مقادیر بالاتر و در بازارهای کم‌نوسان مقادیر پایین‌تر مناسب‌تر است.

ATR Length — این تنظیم طول دوره محاسبه ATR (میانگین دامنه واقعی) را تعیین می‌کند و مقدار پیش‌فرض آن ۱۴ کندل است که استاندارد رایج در تحلیل تکنیکال محسوب می‌شود. ATR به عنوان معیاری برای اندازه‌گیری نوسان‌پذیری بازار استفاده می‌شود و در این اندیکاتور مبنای سنجش حداقل اندازه میله قرار می‌گیرد؛ بنابراین دقت آن تأثیر مستقیمی بر کیفیت تشخیص میله دارد. مقادیر کمتر ATR حساسیت بیشتر به نوسانات اخیر و مقادیر بیشتر، نوسان‌پذیری بلندمدت‌تر را منعکس می‌کنند و حداقل مقدار مجاز آن ۱ است.

Pivot Length — این تنظیم تعداد کندل‌های چپ و راست مورد نیاز برای تأیید یک سقف یا کف پیوت را مشخص می‌کند و مقدار پیش‌فرض آن ۶ است؛ یعنی پیوت زمانی تأیید می‌شود که ۶ کندل در هر طرف آن قرار گیرد. افزایش این مقدار باعث شناسایی پیوت‌های مهم‌تر و کاهش نویز می‌شود، اما تأخیر در تشخیص را افزایش می‌دهد؛ در حالی که کاهش آن سرعت تشخیص را بالا برده اما ممکن است پیوت‌های کم‌اهمیت نیز وارد محاسبات شوند. بازه مجاز این پارامتر بین ۲ تا ۲۰ کندل است و انتخاب مناسب آن به تایم‌فریم و سطح نویز بازار بستگی دارد.

Touch Tolerance (%) — این تنظیم درصد تحمل برای لمس خطوط روند پرچم را تعیین می‌کند و مقدار پیش‌فرض آن ۰.۳۰ درصد است؛ به این معنا که قیمت می‌تواند تا این میزان از خط روند فاصله داشته باشد و همچنان به عنوان لمس معتبر شناخته شود. افزایش این مقدار باعث انعطاف‌پذیری بیشتر در تشخیص پرچم‌ها شده اما ممکن است الگوهای نامعتبر را نیز شامل شود، در حالی که کاهش آن دقت را بالا برده اما ممکن است پرچم‌های معتبر را از دست بدهد. بازه مجاز این پارامتر بین ۰.۰۵ تا ۲.۰ درصد با گام ۰.۰۵ قابل تنظیم است و باید با نوسان‌پذیری نماد مورد معامله هماهنگ باشد.

Maximum Flag Length (Bars) — این تنظیم حداکثر طول مجاز پرچم را بر حسب تعداد کندل تعیین می‌کند و مقدار پیش‌فرض آن ۴۰ کندل است؛ اگر پرچم بیش از این تعداد کندل ادامه یابد، منقضی شده و خطوط روند آن متوقف می‌شوند. این پارامتر از تشخیص پرچم‌های طولانی و بی‌اعتبار که ممکن است به روندهای جانبی یا تثبیت‌های طولانی تبدیل شوند جلوگیری می‌کند و به حفظ کیفیت سیگنال‌ها کمک می‌کند. بازه مجاز آن بین ۱۰ تا ۱۵۰ کندل است و انتخاب مقدار مناسب به تایم‌فریم معاملاتی و سرعت حرکت بازار بستگی دارد.

Minimum Trendline Slope (%) — این تنظیم حداقل شیب مورد نیاز برای خطوط روند پرچم را بر حسب درصد تعیین می‌کند و مقدار پیش‌فرض آن ۰.۰۲ درصد است؛ پرچم‌هایی که شیب خط روند آن‌ها کمتر از این مقدار باشد نامعتبر تلقی می‌شوند. افزایش این مقدار باعث فیلتر کردن پرچم‌های کم‌شیب و نزدیک به افقی شده و کیفیت الگوهای شناسایی‌شده را بالا می‌برد، اما ممکن است برخی پرچم‌های معتبر با شیب ملایم را نیز حذف کند. حداقل مقدار مجاز آن ۰.۰ و گام تنظیم آن ۰.۰۱ است؛ برای بازارهای کم‌نوسان مقادیر پایین‌تر و برای بازارهای پرنوسان مقادیر بالاتر توصیه می‌شود.

Show Pole Labels — این تنظیم نمایش برچسب‌های متنی مربوط به میله را کنترل می‌کند و مقدار پیش‌فرض آن فعال (true) است؛ زمانی که فعال باشد، برچسب‌های «Bullish Flag» و «Bearish Flag» روی چارت نمایش داده می‌شوند. این برچسب‌ها به معامله‌گر کمک می‌کنند تا به سرعت نقاط شکل‌گیری پرچم‌های صعودی و نزولی را روی چارت شناسایی کند و دید بصری بهتری نسبت به ساختار الگو داشته باشد. غیرفعال کردن این گزینه برای معامله‌گرانی مناسب است که چارت شلوغ را ترجیح نمی‌دهند یا فقط به سیگنال‌های شکست اهمیت می‌دهند.

Show Flag Trendlines — این تنظیم نمایش خطوط روند مربوط به پرچم را کنترل می‌کند و مقدار پیش‌فرض آن فعال (true) است؛ زمانی که فعال باشد، خطوط مقاومت و حمایت پرچم به صورت خط‌چین روی چارت رسم می‌شوند. این خطوط روند نقش کلیدی در تعیین سطوح شکست دارند و به معامله‌گر امکان می‌دهند تا نقاط ورود و خروج بالقوه را به صورت بصری شناسایی کند و مرزهای پرچم را به وضوح ببیند. غیرفعال کردن این گزینه برای تحلیل‌های ساده‌تر یا زمانی که کاربر از خطوط روند خودش استفاده می‌کند، کاربرد دارد.

Show BUY / SELL Signals — این تنظیم نمایش سیگنال‌های خرید و فروش را کنترل می‌کند و مقدار پیش‌فرض آن فعال (true) است؛ زمانی که فعال باشد، مثلث‌های سبز با برچسب «BUY» زیر کندل شکست صعودی و مثلث‌های قرمز با برچسب «SELL» بالای کندل شکست نزولی نمایش داده می‌شوند. این سیگنال‌ها نقطه اصلی کاربرد اندیکاتور هستند و به معامله‌گر امکان می‌دهند تا بدون نیاز به بررسی دستی، نقاط ورود به معامله را شناسایی کند. غیرفعال کردن این گزینه برای معامله‌گرانی مناسب است که فقط می‌خواهند الگوها را ببینند و تصمیم‌گیری نهایی را خودشان انجام دهند.

Show Breakout Labels — این تنظیم نمایش برچسب‌های متنی مربوط به شکست را کنترل می‌کند و مقدار پیش‌فرض آن فعال (true) است؛ زمانی که فعال باشد، برچسب‌های «FLAG BREAKOUT BUY» و «FLAG BREAKDOWN SELL» روی کندل‌های شکست نمایش داده می‌شوند. این برچسب‌ها اطلاعات تکمیلی و تأییدی درباره وقوع شکست ارائه می‌دهند و به معامله‌گر کمک می‌کنند تا بین سیگنال‌های شکست و سایر رویدادهای چارت تمایز قائل شود. غیرفعال کردن این گزینه برای چارت‌های شلوغ یا زمانی که کاربر فقط به سیگنال‌های بصری مثلث‌ها اکتفا می‌کند، توصیه می‌شود.