این اندیکاتور Pine Script با نام «Multi-Timeframe FVG [Custom]» برای شناسایی و نمایش شکاف‌های ارزش منصفانه (Fair Value Gaps) در چند تایم‌فریم مختلف طراحی شده است. برخلاف اندیکاتورهای ساده FVG که فقط بر تایم‌فریم فعلی نمودار تمرکز می‌کنند، این ابزار می‌تواند هم‌زمان چهار تایم‌فریم مستقل را رصد کند و هر کدام را با رنگ، ضخامت، سبک خط و تنظیمات نمایشی مجزا روی چارت نشان دهد. این انعطاف باعث می‌شود معامله‌گر بتواند ساختارهای چندلایه بازار را یکجا ببیند؛ مثلاً FVGهای یک‌دقیقه‌ای را در کنار FVGهای پنج‌دقیقه‌ای، پانزده‌دقیقه‌ای و ساعتی داشته باشد.

نحوه تشخیص FVG در این اسکریپت بر پایه مقایسه سه کندل متوالی بنا شده است. برای FVG صعودی، کمینه کندل جاری باید بالاتر از بیشینه کندل سه‌بار قبل باشد و برای FVG نزولی، بیشینه کندل جاری باید پایین‌تر از کمینه کندل سه‌بار قبل قرار گیرد. نکته کلیدی این است که در حالت عادی تنها از کندل‌های کاملاً بسته‌شده استفاده می‌شود (با آفست‌های [3] و [1]) تا از ری‌پینت جلوگیری شود. همچنین وقتی تایم‌فریم انتخابی پایین‌تر از تایم‌فریم چارت باشد، اسکریپت به‌جای request.security معمولی از request.security_lower_tf استفاده می‌کند تا تمام کندل‌های بسته‌شده داخل کندل جاری چارت را ببیند و FVGهای ریز را از دست ندهد.

مدیریت و حذف FVGها در این اندیکاتور بسیار دقیق پیاده‌سازی شده است. هر FVG تنها زمانی «mitigated» (پر شده) در نظر گرفته می‌شود که یک کندل از همان تایم‌فریم FVG با Close خود به‌طور کامل از مرز دورتر شکاف در جهت مخالف عبور کند؛ یعنی برای FVG صعودی، Close زیر کف شکاف و برای FVG نزولی، Close بالای سقف شکاف. علاوه بر این، FVGهایی که از تعداد مشخصی کندل (Lookback) قدیمی‌تر شوند نیز به‌صورت خودکار حذف می‌شوند. گزینه «Remove When Mitigated» به کاربر اجازه می‌دهد تصمیم بگیرد آیا FVGهای پر شده کاملاً حذف شوند یا فقط علامت‌گذاری شوند.

از نظر بصری، هر FVG به‌صورت یک باکس رنگی با حاشیه، خط میانی اختیاری و برچسب متنی قابل تنظیم نمایش داده می‌شود. رنگ و ضخامت خط میانی و همچنین رنگ برچسب همیشه از رنگ و ضخامت حاشیه همان FVG پیروی می‌کنند تا ظاهر یکپارچه بماند. برچسب‌ها می‌توانند به‌صورت چپ‌چین یا راست‌چین، در موقعیت عمودی میانه، بالا یا پایین FVG قرار بگیرند و متن آن‌ها با placeholder {tf} به‌صورت خودکار نام تایم‌فریم را نشان دهد. اندازه برچسب به‌صورت سراسری برای هر چهار تایم‌فریم یک‌بار تنظیم می‌شود.

یکی از ویژگی‌های کاربردی این اسکریپت، حالت «Extend Boxes to Latest Bar» است که باعث می‌شود باکس‌ها و خطوط میانی FVGهای فعال تا آخرین کندل چارت امتداد پیدا کنند. در این حالت، برچسب‌های راست‌چین به‌جای چسبیدن به لبه متحرک باکس، با فاصله‌ای قابل تنظیم (بر حسب تعداد کندل چارت) جلوتر از قیمت شناور می‌مانند تا روی اکشن قیمت زنده نیفتند. در نهایت، کاربر می‌تواند برای هر تایم‌فریم به‌طور مستقل تعیین کند که آیا FVGهای آن تایم‌فریم وقتی چارت روی تایم‌فریم بالاتری قرار دارد نمایش داده شوند یا خیر، که این گزینه برای جلوگیری از شلوغی چارت در تایم‌فریم‌های بالا بسیار مفید است.

تنظیمات اندیکاتور Multi-Timeframe FVG [Custom]

Label Size (all timeframes) اندازه برچسب را برای هر چهار تایم‌فریم به‌صورت یکجا تعیین می‌کند و گزینه‌های Tiny، Small، Normal و Large را ارائه می‌دهد. این تنظیم در گروه Label Settings قرار دارد و چون سراسری است، نیازی نیست برای هر تایم‌فریم جداگانه اندازه برچسب را مشخص کنید. پیش‌فرض آن Small است و روی متن تمام برچسب‌های FVG در همه تایم‌فریم‌ها اعمال می‌شود.

Right-aligned Label Offset فاصله افقی برچسب‌های راست‌چین را بر حسب تعداد کندل چارت، جلوتر از قیمت جاری تعیین می‌کند. این گزینه فقط در حالت Extend و وقتی Horizontal Position روی Right باشد اثر دارد و باعث می‌شود برچسب به لبه متحرک باکس نچسبد. حداقل مقدار آن صفر است و پیش‌فرض ۲۰ کندل چارت در نظر گرفته شده است.

Enable (Timeframe 1 تا Timeframe 4) فعال یا غیرفعال بودن رصد و نمایش FVGهای هر تایم‌فریم را به‌صورت مستقل کنترل می‌کند. هر تایم‌فریم یک چک‌باکس جداگانه دارد تا بتوانید فقط تایم‌فریم‌های موردنیاز خود را روی چارت نگه دارید. به‌صورت پیش‌فرض تایم‌فریم ۱ و ۲ فعال و تایم‌فریم ۳ و ۴ غیرفعال هستند.

Timeframe (Timeframe 1 تا Timeframe 4) تایم‌فریمی را که اندیکاتور باید روی آن FVGها را شناسایی کند مشخص می‌کند. مقادیر پیش‌فرض به‌ترتیب ۱، ۵، ۱۵ و ۶۰ دقیقه هستند و می‌توانید هر تایم‌فریم دلخواهی مانند ۳، ۳۰ یا ۲۴۰ را وارد کنید. این تنظیم پایه محاسبه کندل‌های سه‌گانه برای تشخیص شکاف و همچنین مبنای حذف FVGهای قدیمی است.

Show when chart TF is higher than this TF تعیین می‌کند آیا FVGهای این تایم‌فریم وقتی چارت روی تایم‌فریم بالاتری قرار دارد نمایش داده شوند یا خیر. اگر خاموش باشد، مثلاً FVGهای یک‌دقیقه‌ای روی چارت H1 پنهان می‌شوند تا چارت شلوغ نشود. پیش‌فرض آن روشن است و برای همه تایم‌فریم‌ها به‌صورت جداگانه قابل تغییر است.

Fill (Bullish / Bearish) رنگ پرکننده داخل باکس FVG را برای شکاف‌های صعودی و نزولی به‌صورت مجزا مشخص می‌کند. رنگ‌های پیش‌فرض برای تایم‌فریم‌ها ترکیبی از teal، lime، blue و purple برای صعودی و red، orange، maroon و fuchsia برای نزولی است. این رنگ با شفافیت ۸۵ درصد اعمال می‌شود تا قیمت زیر آن قابل مشاهده بماند.

Border (Bullish / Bearish) رنگ حاشیه باکس FVG را تعیین می‌کند و همین رنگ به‌طور خودکار برای خط میانی و متن برچسب نیز استفاده می‌شود. رنگ پیش‌فرض هر تایم‌فریم با رنگ Fill آن هم‌خانواده است تا ظاهر یکپارچه بماند. تغییر این رنگ بلافاصله روی باکس، خط میانی و برچسب همان FVG اثر می‌گذارد.

Width (Bullish / Bearish) ضخامت خط حاشیه باکس FVG را بین ۱ تا ۵ تعیین می‌کند. همین ضخامت به‌صورت خودکار روی خط میانی همان FVG نیز اعمال می‌شود. پیش‌فرض آن ۱ است و برای هر تایم‌فریم و هر جهت به‌صورت جداگانه قابل تنظیم است.

Style (Bullish / Bearish) سبک خط حاشیه باکس را از بین Solid، Dashed و Dotted انتخاب می‌کند. این تنظیم برای شکاف‌های صعودی و نزولی هر تایم‌فریم جداگانه است. پیش‌فرض آن Solid است و روی ظاهر بصری مرزهای FVG اثر می‌گذارد.

Show Midline فعال یا غیرفعال بودن نمایش خط میانی افقی داخل باکس FVG را کنترل می‌کند. رنگ و ضخامت این خط همیشه از رنگ و ضخامت حاشیه همان FVG پیروی می‌کند و تنظیم جداگانه‌ای ندارد. پیش‌فرض آن خاموش است و برای هر تایم‌فریم جداگانه قابل تغییر است.

Style (Midline) سبک خط میانی را از بین Solid، Dashed و Dotted انتخاب می‌کند. این تنظیم فقط زمانی اثر دارد که Show Midline روشن باشد. پیش‌فرض آن Dashed است و برای هر تایم‌فریم مستقل تنظیم می‌شود.

Extend Boxes to Latest Bar باکس FVG و خط میانی آن را تا آخرین کندل چارت امتداد می‌دهد تا شکاف فعال به‌روز بماند. در این حالت برچسب‌های راست‌چین با فاصله تعیین‌شده در تنظیم Right-aligned Label Offset جلوتر از قیمت شناور می‌مانند. پیش‌فرض آن خاموش است و برای هر تایم‌فریم جداگانه کنترل می‌شود.

Box Width عرض باکس FVG را بر حسب تعداد کندل بومی همان تایم‌فریم تعیین می‌کند و فقط وقتی Extend خاموش باشد استفاده می‌شود. این مقدار در زمان ایجاد FVG محاسبه و به‌عنوان لبه راست باکس ثبت می‌شود. پیش‌فرض آن ۲۰ کندل بومی است و حداقل مقدار آن ۱ است.

Lookback حداکثر عمر FVG را بر حسب تعداد کندل بومی همان تایم‌فریم مشخص می‌کند. FVGهایی که از این تعداد کندل قدیمی‌تر شوند، فارغ از وضعیت mitigation به‌صورت خودکار حذف می‌شوند. پیش‌فرض آن ۳۰۰ کندل بومی است و حداقل مقدار آن ۱ است.

Max FVGs Displayed حداکثر تعداد FVGهایی را که هم‌زمان در هر تایم‌فریم روی چارت نگه داشته می‌شوند تعیین می‌کند. با عبور از این تعداد، قدیمی‌ترین FVG به‌صورت خودکار از آرایه حذف و از چارت پاک می‌شود. پیش‌فرض آن ۲۰ و محدوده مجاز آن بین ۱ تا ۱۰۰ است.

Remove When Mitigated تعیین می‌کند FVGهایی که پر شده‌اند کاملاً حذف شوند یا فقط علامت‌گذاری شوند. منطق mitigation تنها زمانی فعال می‌شود که یک کندل از همان تایم‌فریم FVG با Close خود کاملاً از مرز دورتر شکاف در جهت مخالف عبور کند. پیش‌فرض آن روشن است و برای هر تایم‌فریم جداگانه قابل تنظیم است.

Show Label فعال یا غیرفعال بودن نمایش برچسب متنی روی FVG را کنترل می‌کند. رنگ متن برچسب همیشه از رنگ حاشیه همان FVG پیروی می‌کند و اندازه آن از تنظیم سراسری Label Size گرفته می‌شود. پیش‌فرض آن روشن است و برای هر تایم‌فریم مستقل قابل تغییر