این اندیکاتور با نام «FVG and Order Blocks Detector» (با نام اختصاری IOB Zones) یک ابزار تحلیل تکنیکال برای ترسیم خودکار نواحی «شکاف ارزش منصفانه» (Fair Value Gap یا FVG) و «بلوک‌های سفارش» (Order Blocks یا OB) روی چارت قیمت است. این اسکریپت توسط Michael_Fx_Trader نوشته شده و به‌صورت اورلی (روی چارت اصلی) اجرا می‌شود. هدف اصلی آن شناسایی نواحی کلیدی عرضه و تقاضاست که معامله‌گران پرایس‌اکشن معمولاً به‌عنوان نقاط بالقوه برای ورود یا خروج معاملات در نظر می‌گیرند. اندیکاتور به‌گونه‌ای طراحی شده که هم برای تایم‌فریم جاری و هم برای تایم‌فریم‌های بالاتر قابل استفاده باشد و بتواند شکاف‌ها را روی تایم‌فریم دلخواه کاربر شناسایی کند.

بخش مربوط به شکاف‌های ارزش منصفانه (FVG) بر پایه الگوی سه‌کندلی ساخته شده است؛ به این صورت که اگر کندل سوم بالاتر از سقف کندل اول بسته شود، یک FVG صعودی و اگر پایین‌تر از کف کندل اول بسته شود، یک FVG نزولی تشکیل می‌شود. کاربر می‌تواند حداقل اندازه شکاف را بر اساس مضربی از ATR(14) تعیین کند تا شکاف‌های کوچک و کم‌اهمیت فیلتر شوند. همچنین سه حالت مختلف برای «مرتفع شدن» (Mitigation) شکاف قابل انتخاب است: لمس ساده (Touch)، پر شدن ۵۰ درصدی، و پر شدن کامل. علاوه بر این، امکان استفاده از تایم‌فریم بالاتر برای شناسایی FVG نیز فراهم شده که با استفاده از request.security و بدون lookahead پیاده‌سازی شده تا از ریپینت شدن جلوگیری شود.

بخش بلوک‌های سفارش (Order Blocks) بر اساس شناسایی نقاط سوئینگ (Swing High و Swing Low) و سپس شکست آن‌ها کار می‌کند. زمانی که یک سوئینگ های شکسته می‌شود، آخرین کندل نزولی قبل از شکست به‌عنوان بلوک تقاضا (صعودی) و زمانی که سوئینگ لو شکسته می‌شود، آخرین کندل صعودی قبل از شکست به‌عنوان بلوک عرضه (نزولی) در نظر گرفته می‌شود. کاربر می‌تواند تعیین کند که شکست با «بسته شدن کندل» تأیید شود یا با «شدو» (Wick)، و همچنین فیلتر جابجایی (Displacement) را فعال کند تا فقط شکست‌هایی که دامنه کندل شکست‌دهنده حداقل چند برابر ATR است معتبر شناخته شوند. حالت بدنه بلوک (کل کندل یا فقط بدنه) و منبع مرتفع شدن (Close یا Wick) نیز قابل تنظیم است.

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

در نهایت، اندیکاتور دارای یک سیستم هشدار (Alert) کامل است که برای هر رویداد مهم—ایجاد FVG صعودی/نزولی، پر شدن FVG صعودی/نزولی، ایجاد بلوک سفارش از شکست صعودی/نزولی، و مرتفع شدن بلوک سفارش صعودی/نزولی—یک alertcondition جداگانه ارائه می‌دهد. این امکان را به معامله‌گر می‌دهد تا بدون نیاز به رصد مداوم چارت، از وقوع سیگنال‌های مهم مطلع شود. نکته مهم اینکه تمام محاسبات در این اندیکاتور روی کندل‌های تأییدشده (barstate.isconfirmed) انجام می‌شود تا از ریپینت شدن و نمایش سیگنال‌های نادرست جلوگیری شود. در مجموع، این ابزار یک سیستم کامل و قابل تنظیم برای شناسایی و مدیریت نواحی عرضه و تقاضا در پرایس‌اکشن ارائه می‌دهد.

تنظیمات اندیکاتور  FVG and Order Blocks Detector

Max Zones Per Type حداکثر تعداد نواحی نگه‌داری‌شده برای هر نوع را تعیین می‌کند؛ یعنی حداکثر تعداد FVG صعودی، FVG نزولی، بلوک سفارش صعودی و بلوک سفارش نزولی به‌صورت جداگانه. مقدار پیش‌فرض ۵ است و بازه مجاز آن از ۱ تا ۳۰ متغیر است. زمانی که تعداد نواحی یک نوع از این حد فراتر رود، قدیمی‌ترین ناحیه از همان نوع حذف می‌شود تا تعداد نواحی روی چارت کنترل شود.

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

Label Text Size اندازه متن برچسب‌های نواحی را تعیین می‌کند و گزینه‌های آن شامل Tiny، Small، Normal و Large است. این تنظیم به‌طور خودکار برای نواحی باریک‌تر از حدود ۲۵ کندل به Tiny تغییر می‌کند تا متن برچسب داخل ناحیه جا شود. به این ترتیب خوانایی برچسب‌ها در نواحی با عرض کم حفظ می‌شود.

Label Text Color رنگ متن برچسب‌های نواحی را مشخص می‌کند و مقدار پیش‌فرض آن رنگ تیره (#131722) است. این رنگ برای متن تمام برچسب‌های FVG و بلوک سفارش به‌کار می‌رود. کاربر می‌تواند آن را متناسب با تم رنگی چارت خود تغییر دهد.

Bold Labels مشخص می‌کند که متن برچسب‌های نواحی به‌صورت پررنگ (Bold) ترسیم شود یا خیر. اگر فعال باشد، از قالب‌بندی متن پررنگ Pine استفاده می‌شود. مقدار پیش‌فرض این گزینه فعال (true) است.

Naming Convention روش نام‌گذاری بلوک‌های سفارش را تعیین می‌کند و دو گزینه Standard و Reversed دارد. در حالت Standard، بلوک صعودی آخرین کندل نزولی قبل از شکست رو به بالا و بلوک نزولی آخرین کندل صعودی قبل از شکست رو به پایین است. در حالت Reversed فقط برچسب‌های نمایشی و نام هشدارها جابجا می‌شوند، اما منطق تشخیص و مرتفع شدن یکسان باقی می‌ماند.

Color Theme تم رنگی نواحی را تعیین می‌کند و دو گزینه Gray Classic و Directional Colors دارد. در حالت Gray Classic تمام نواحی با یک رنگ خاکستری خنثی نمایش داده می‌شوند. در حالت Directional Colors هر نوع ناحیه و جهت آن رنگ مخصوص به خود را دریافت می‌کند.

Bullish FVG (Directional) رنگ FVG صعودی را در حالت تم Directional Colors تعیین می‌کند. مقدار پیش‌فرض آن سبز با شفافیت ۷۵ درصد است. این رنگ فقط زمانی اعمال می‌شود که تم رنگی روی Directional Colors تنظیم شده باشد.

Bearish FVG (Directional) رنگ FVG نزولی را در حالت تم Directional Colors تعیین می‌کند. مقدار پیش‌فرض آن قرمز با شفافیت ۷۵ درصد است. این رنگ تنها در صورت انتخاب تم Directional Colors روی نواحی نزولی اعمال می‌شود.

Bullish OB (Directional) رنگ بلوک سفارش صعودی را در حالت تم Directional Colors تعیین می‌کند. مقدار پیش‌فرض آن آبی با شفافیت ۷۵ درصد است. این رنگ فقط در تم Directional Colors برای بلوک‌های صعودی استفاده می‌شود.

Bearish OB (Directional) رنگ بلوک سفارش نزولی را در حالت تم Directional Colors تعیین می‌کند. مقدار پیش‌فرض آن قرمز با شفافیت ۷۵ درصد است. این رنگ تنها در صورت فعال بودن تم Directional Colors برای بلوک‌های نزولی به‌کار می‌رود.

Show FVGs مشخص می‌کند که شکاف‌های ارزش منصفانه (FVG) روی چارت ترسیم شوند یا خیر. اگر فعال باشد، تشخیص و ترسیم FVG انجام می‌شود. مقدار پیش‌فرض این گزینه فعال (true) است.

FVG Timeframe تایم‌فریم مورد استفاده برای تشخیص FVG را تعیین می‌کند. اگر خالی بماند، از تایم‌فریم خود چارت استفاده می‌شود. در صورت وارد کردن تایم‌فریم بالاتر، الگوی سه‌کندلی روی کندل‌های تأییدشده آن تایم‌فریم محاسبه می‌شود.

Minimum Gap Size (ATR multiple) حداقل اندازه شکاف برای معتبر شناخته شدن FVG را بر حسب مضربی از ATR(14) تعیین می‌کند. مقدار پیش‌فرض ۰.۱ است و بازه مجاز آن از ۰ تا ۵ با گام ۰.۰۵ متغیر است. شکاف‌های کوچک‌تر از این مقدار نادیده گرفته می‌شوند.

Mitigation Mode حالت مرتفع شدن FVG را تعیین می‌کند و سه گزینه Touch، 50 Percent Fill و Full Fill دارد. در حالت Touch کافی است قیمت ناحیه را لمس کند، در حالت 50 Percent Fill باید تا میانه ناحیه پر شود، و در حالت Full Fill باید کل ناحیه پر شود. مقدار پیش‌فرض Full Fill است.

FVG Label Text متنی که روی برچسب نواحی FVG نمایش داده می‌شود را تعیین می‌کند. مقدار پیش‌فرض آن «FVG» است. کاربر می‌تواند این متن را به دلخواه خود تغییر دهد.

Show Order Blocks مشخص می‌کند که بلوک‌های سفارش (Order Blocks) روی چارت ترسیم شوند یا خیر. اگر فعال باشد، تشخیص و ترسیم بلوک‌ها انجام می‌شود. مقدار پیش‌فرض این گزینه فعال (true) است.

Swing Lookback تعداد کندل‌های مورد نیاز در هر طرف برای تأیید یک سوئینگ های یا سوئینگ لو را تعیین می‌کند. مقدار پیش‌فرض ۸ است و بازه مجاز آن از ۳ تا ۵۰ متغیر است. افزایش این مقدار باعث می‌شود فقط سوئینگ‌های مهم‌تر شناسایی شوند.

Break Confirmation نحوه تأیید شکست سطح سوئینگ را تعیین می‌کند و دو گزینه Candle Close و Wick دارد. در حالت Candle Close باید کندل به‌طور کامل فراتر از سطح سوئینگ بسته شود. در حالت Wick هر شدو فراتر از سطح برای شکست کافی است.

Displacement Filter مشخص می‌کند که فیلتر جابجایی برای شکست‌ها اعمال شود یا خیر. اگر فعال باشد، دامنه کامل کندل شکست‌دهنده باید حداقل به اندازه مضربی از ATR(14) باشد. مقدار پیش‌فرض این گزینه فعال (true) است.

Displacement Multiplier مقدار مضرب ATR برای فیلتر جابجایی را تعیین می‌کند. مقدار پیش‌فرض ۱.۲ است و بازه مجاز آن از ۰.۵ تا ۵ با گام ۰.۱ متغیر است. این تنظیم تنها زمانی اعمال می‌شود که فیلتر جابجایی فعال باشد.

Block Body Mode نحوه تعیین محدوده بلوک سفارش را مشخص می‌کند و دو گزینه Full Candle (High to Low) و Body Only (Open to Close) دارد. در حالت Full Candle از سقف تا کف کندل استفاده می‌شود. در حالت Body Only فقط از باز تا بسته کندل به‌عنوان محدوده بلوک در نظر گرفته می‌شود.

Mitigation Source منبع قیمتی برای تشخیص مرتفع شدن بلوک سفارش را تعیین می‌کند و دو گزینه Close و Wick دارد. در حالت Close بلوک تنها زمانی مرتفع می‌شود که قیمت از آن عبور کند. در حالت Wick هر شدویی که از بلوک عبور کند آن را مرتفع می‌کند.

Bullish OB Label Text متن برچسب بلوک سفارش صعودی را تعیین می‌کند. مقدار پیش‌فرض آن «BULLISH ORDER BLOCK» است. این متن روی برچسب نواحی صعودی نمایش داده می‌شود.

Bearish OB Label Text متن برچسب بلوک سفارش نزولی را تعیین می‌کند. مقدار پیش‌فرض آن «BEARISH ORDER BLOCK» است. این متن روی برچسب نواحی نزولی نمایش داده می‌شود.