این اسکریپت یک استراتژی معاملاتی کامل برای طلا (Gold) در تایم‌فریم ۱۵ دقیقه است که بر پایه شکست محدوده‌ی شبانه (Overnight Range Breakout) طراحی شده است. فلسفه‌ی اصلی آن ساده اما قدرتمند است: در ساعات آرام بازار (به‌طور پیش‌فرض از نیمه‌شب تا ساعت ۷ صبح به وقت بروکر)، یک محدوده‌ی قیمتی شامل سقف و کف روزانه شکل می‌گیرد. سپس با شروع سشن معاملاتی اصلی، استراتژی دو سفارش استاپ (Stop Order) روی هر دو مرز این محدوده قرار می‌دهد تا اولین شکست را شکار کند. به محض پر شدن یکی از سفارش‌ها، سفارش مقابل به‌صورت خودکار لغو می‌شود و تنها یک معامله در روز انجام می‌گیرد. این رویکرد سعی دارد از حرکات قوی و جهت‌دار پس از فاز تثبیت اولیه بهره ببرد.

 بخش مدیریت ریسک این استراتژی بسیار جامع و حرفه‌ای طراحی شده است. حد ضرر (Stop-Loss) به دو روش قابل تنظیم است: یا بر اساس درصدی از قیمت ورود (پیش‌فرض ۱٪)، یا بر اساس مرز مقابل محدوده. حجم معامله نیز به دو صورت محاسبه می‌شود: درصدی از سرمایه در معرض ریسک (پیش‌فرض ۱٪) یا حجم ثابت. استراتژی حتی اهرم بیشینه (Max Leverage)، گام حجم (Quantity Step) و اندازه‌ی قرارداد را نیز در نظر می‌گیرد تا ریسک واقعی از بودجه‌ی تعیین‌شده فراتر نرود. علاوه بر این، یک «گارد پراپ‌فرم» (Prop Firm Guard) تعبیه شده که در صورت افت سرمایه‌ی روزانه بیش از حد مجاز (پیش‌فرض ۴٪)، همه‌ی پوزیشن‌ها را بسته و تا روز بعد معامله را متوقف می‌کند. خروج از معامله نیز یا با برخورد به حد ضرر انجام می‌شود یا با بستن اجباری در ساعت مشخص (پیش‌فرض ۲۰:۰۰) — چون استراتژی حد سود (Take-Profit) ندارد.

 اسکریپت دارای یک داشبورد حرفه‌ای است که وضعیت لحظه‌ای استراتژی را نمایش می‌دهد: روند فعلی، سیگنال، محدوده‌ی قیمتی، عرض محدوده، سود/زیان باز، دراودان روزانه و برنامه‌ی کامل پوزیشن (حد ضرر، فاصله‌ی حد ضرر، حجم، ارزش قرارداد و اهرم). بخش «Strategy Math» نیز آمار دقیقی مانند نرخ برد، نرخ برد سر‌به‌سر، فاکتور سود، نسبت پاداش به ریسک، امید ریاضی و بیشترین رشته‌ی ضرر را محاسبه و نمایش می‌دهد. علاوه بر این، امکان نمایش نمودار عملکرد (Performance Chart) به‌صورت منحنی تجمعی سود/زیان روی چارت وجود دارد. از نظر بصری، جعبه‌ی محدوده، برچسب‌های ورود و خروج، جعبه‌ی معامله، خطوط حد ضرر و واترمارک نیز قابل تنظیم هستند.

 یکی از نقاط قوت این استراتژی، سیستم هشدار (Alert) پیشرفته‌ی آن است. پیام‌های هشدار به‌صورت قالب‌های متنی یا JSON قابل شخصی‌سازی هستند و می‌توانند مستقیماً به ربات‌های معاملاتی یا وب‌هوک ارسال شوند. پلیس‌هولدرهایی مانند {{price}}, {{sl}}, {{qty}}, {{risk_usd}}, {{range_high}}, {{range_low}}, {{secret}} و… در قالب‌ها جایگزین می‌شوند. نکته‌ی مهم این است که در حالت «درصدی از ورود»، حد ضرر پس از پر شدن سفارش از قیمت واقعی پر شدن بازتنظیم می‌شود و هشدار جداگانه‌ای ارسال نمی‌گردد؛ بنابراین ربات باید خودش با استفاده از {{sl_pct}} حد ضرر را محاسبه کند. همچنین امکان پیش‌نمایش پیام‌ها در Pine Logs برای تست قالب‌ها فراهم شده است.

برای استفاده‌ی درست از این استراتژی، باید چند نکته را در نظر گرفت. اول اینکه استراتژی برای طلا و تایم‌فریم ۱۵ دقیقه ساخته شده و تایم‌فریم باید ساعتی را به‌طور مساوی تقسیم کند (۱ تا ۶۰ دقیقه) و از کندل‌های استاندارد استفاده شود؛ در غیر این صورت محدوده‌ی قیمتی ممکن است نادرست محاسبه شود. دوم، تنظیم دقیق حالت زمان بروکر (Broker Time Mode) و منطقه‌ی زمانی بروکر (Broker Timezone) حیاتی است، چون محدوده‌ی شبانه کاملاً به ساعت سرور بروکر وابسته است. سوم، هزینه‌های معاملاتی مانند کمیسیون (پیش‌فرض ۰.۴ در هر سفارش)، اسپرد و لغزش (Slippage) در نتایج بک‌تست تأثیرگذارند و باید در تنظیمات Properties به‌درستی وارد شوند. چهارم، سفارش‌ها در بسته‌شدن کندل محاسبه و در کندل بعدی پر می‌شوند. در نهایت، ریسک هر معامله یک هدف است و هزینه‌ها، گپ‌ها و اسپرد می‌توانند ضرر واقعی را از مقدار برنامه‌ریزی‌شده بیشتر کنند.

تنظیمات اندیکاتور Gold Breakout 15M 

Broker Time Mode — نحوه‌ی استخراج زمان سرور بروکر را تعیین می‌کند. در حالت Fixed timezone از منطقه‌ی زمانی ثابت زیر استفاده می‌شود و در حالت New York + 7h ساعت نیویورک به‌علاوه‌ی ۷ ساعت (مطابق تقویم DST آمریکا) مبنای محاسبه است.

Broker Timezone — فقط در حالت Fixed timezone استفاده می‌شود و منطقه‌ی زمانی سرور بروکر را مشخص می‌کند. تمام ساعات سشن (شروع و پایان محدوده و ساعت بستن) بر اساس این زمان تفسیر می‌شوند. اکثر بروکرهای فارکس و CFD در زمستان GMT+2 و در تابستان GMT+3 دارند.

Range Start Hour — ساعتی (به وقت بروکر) که محدوده‌ی قیمتی روزانه شروع به شکل‌گیری می‌کند. پیش‌فرض ۰ یعنی از ابتدای روز بروکر. هرچه این ساعت دیرتر باشد، محدوده‌ی کوتاه‌تری ساخته می‌شود.

Range End / Trading Start Hour — ساعتی که محدوده تثبیت می‌شود و معامله‌ی شکست آغاز می‌گردد. پیش‌فرض ۷ یعنی محدوده از ۰۰:۰۰ تا ۰۶:۵۹ ساخته شده و معامله از ۰۷:۰۰ شروع می‌شود. ساعت دیرتر یعنی محدوده‌ی پهن‌تر و شکست‌های کمتر.

Close All Positions Hour — ساعتی که هر پوزیشن باز به‌اجبار بسته می‌شود. پیش‌فرض ۲۰ است. چون استراتژی حد سود ندارد، این ساعت خروج اصلی محسوب می‌شود. باید بزرگ‌تر از Range End باشد.

SL Mode — محل قرارگیری حد ضرر را انتخاب می‌کند. در حالت % of entry حد ضرر درصدی ثابت از قیمت ورود است. در حالت Range boundary حد ضرر روی مرز مقابل محدوده قرار می‌گیرد که در محدوده‌های باریک، استاپ تنگ‌تر و حجم بزرگ‌تر می‌شود.

SL, % of Entry Price — فاصله‌ی حد ضرر بر حسب درصد از قیمت ورود (فقط در حالت % of entry). مقدار بالاتر یعنی استاپ پهن‌تر و حجم کوچک‌تر. پیش‌فرض ۱.۰ درصد است.

Position Size Mode — روش محاسبه‌ی حجم سفارش را تعیین می‌کند. در حالت % equity at risk حجم از فرمول سرمایه × درصد ریسک ÷ فاصله تا استاپ به‌دست می‌آید. در حالت Fixed quantity تعداد قرارداد ثابت است.

Risk per Trade, % of Equity — سهم سرمایه‌ای که در صورت برخورد به استاپ از دست می‌رود. پیشنهاد محافظه‌کارانه ۰.۵، متعادل ۱.۰ و تهاجمی ۲.۰ است. این عدد هدف است و کمیسیون، اسپرد، لغزش و گپ به آن اضافه می‌شوند.

Fixed Quantity (contracts) — حجم سفارش در حالت Fixed quantity. مقدار ثابت قرارداد که مستقل از سرمایه و فاصله‌ی استاپ استفاده می‌شود.

Ounces per Lot (0 = auto) — فقط برای نمایش حجم به واحد لات در برچسب‌ها، داشبورد و پلیس‌هولدر {{lots}} استفاده می‌شود. مقدار ۰ یعنی تشخیص خودکار: ۱۰۰ اونس برای طلا و ۵۰۰۰ اونس برای نقره. روی معاملات تأثیری ندارد.

Max Leverage — سقف نسبت ارزش قرارداد به سرمایه. حجم نهایی کمینه‌ی حجم مبتنی بر ریسک و این سقف است. وقتی سقف فعال شود، ریسک واقعی کمتر از مقدار درخواستی می‌شود که در داشبورد نمایش داده می‌شود.

Quantity Step (0 = auto) — حجم سفارش به سمت پایین به این گام گرد می‌شود تا ریسک برنامه‌ریزی‌شده از بودجه فراتر نرود. مقدار ۰ یعنی استفاده از کمینه‌ی قرارداد نماد. اگر حجم کمتر از یک گام باشد، ورود انجام نمی‌شود.

Prop Firm Guard: Close on Daily Drawdown — در صورت افت سرمایه از سقف روزانه به میزان حد زیر، همه‌چیز بسته شده و تا روز بعد معامله متوقف می‌شود. دراودان در بدترین نقطه‌ی هر کندل اندازه‌گیری می‌شود اما واکنش فقط در بسته‌شدن کندل رخ می‌دهد.

Max Drawdown from Daily Equity Peak, % — حد دراودان روزانه برای گارد پراپ‌فرم. محدودیت معمول پراپ‌فرم‌ها ۴ تا ۵ درصد است.

Show Entry / SL Levels — نمایش خطوط قیمت ورود و حد ضرر همراه با ناحیه‌ی ریسک در زمان باز بودن پوزیشن.

Theme — تم رنگی چارت را تعیین می‌کند. حالت Auto از پس‌زمینه‌ی چارت تشخیص می‌دهد، Dark برای پس‌زمینه‌ی تیره و Light برای پس‌زمینه‌ی روشن بهینه شده است.

Show Range Box & Boundaries — رسم جعبه‌ی محدوده‌ی روزانه و خطوط سقف و کف آن که تا پایان سشن معاملاتی امتداد می‌یابند.

Show Entry Labels — نمایش برچسب در هر ورود شامل جهت، قیمت ورود، حد ضرر، حجم و ریسک.

Show Exit Labels (Trade Result) — نمایش برچسب در هر خروج شامل سود/زیان به پول و به R، درصد حرکت قیمت، قیمت خروج و دلیل خروج.

Show Trade Box (Entry → Exit) — رسم جعبه‌ی سبز یا قرمز بین ورود و خروج هر معامله‌ی بسته‌شده.

Label Size — اندازه‌ی متن برچسب‌های ورود و خروج. گزینه‌ها Small و Normal هستند.

Show Accuracy Warnings — نمایش هشدار در آخرین کندل در صورت احتمال نادرست بودن محدوده: تایم‌فریم بالای ۱ ساعت یا غیرقابل تقسیم بر ساعت، یا چارت غیراستاندارد مانند Heikin Ashi و Renko. فقط جنبه‌ی اطلاع‌رسانی دارد و معامله را غیرفعال نمی‌کند.

Show Watermark — نمایش واترمارک WillyAlgoTrader روی چارت.

Show Dashboard — نمایش پنل وضعیت شامل محدوده، سشن و ماشین‌حساب پوزیشن.

Show Strategy Math — نمایش آمار معاملات شامل نرخ برد، نرخ برد سر‌به‌سر، فاکتور سود، پاداش به ریسک، امید ریاضی به پول و R، دراودان و رشته‌ی ضرر. R یعنی نتیجه‌ی معامله تقسیم بر ریسک اولیه تا استاپ.

Dashboard Position — گوشه‌ی چارت که داشبورد در آن قرار می‌گیرد: Top Left، Top Right، Bottom Left، Bottom Right یا Middle Right.

Dashboard Text Size — اندازه‌ی متن ردیف‌های داشبورد: Small، Normal یا Large.

Show Performance Chart — نمایش منحنی تجمعی سود/زیان همراه با آمار کلیدی روی چارت. این منحنی از معاملات بسته‌شده روی کندل‌های بارگذاری‌شده ساخته می‌شود، نه از محدوده‌ی Deep Backtesting. فقط کندل‌های پشت آن را پوشش می‌دهد.

Chart Position — محل قرارگیری نمودار عملکرد: Bottom Left، Bottom Center، Bottom Right، Middle Center، Top Left یا Top Center. در حالت Bottom Center واترمارک مخفی می‌شود و اگر با داشبورد هم‌گوشه باشد هشدار نمایش داده می‌شود.

Chart Columns — رزولوشن افقی منحنی. مقدار بالاتر یعنی منحنی نرم‌تر ولی رسم کندتر. محدوده‌ی پیشنهادی ۶۰ تا ۱۰۰ است.

Chart Rows — رزولوشن عمودی منحنی. مقدار بالاتر یعنی پله‌های ریزتر ولی رسم کندتر. محدوده‌ی پیشنهادی ۲۴ تا ۴۰ است.

Chart Width, % of Screen — عرض ناحیه‌ی منحنی به‌عنوان سهمی از پنل چارت.

Chart Height, % of Screen — ارتفاع ناحیه‌ی منحنی به‌عنوان سهمی از پنل چارت.

Enable Alert Messages — در صورت خاموش بودن، پیام‌های هشدار سفارش‌ها خالی ارسال می‌شوند. برای راه‌اندازی، یک هشدار روی استراتژی بسازید و فقط {{strategy.order.alert_message}} را در فیلد Message بگذارید.

Webhook JSON Format — روشن یعنی قالب‌های JSON ارسال می‌شوند (برای ربات‌ها و وب‌هوک) و خاموش یعنی قالب‌های متنی. پلیس‌هولدرهای موجود در تولتیپ این گزینه فهرست شده‌اند.

Bot Secret → {{secret}} — جایگزین {{secret}} در قالب‌ها می‌شود. توجه: این مقدار در تنظیمات چارت ذخیره و برای هر کسی که چارت را با او به اشتراک بگذارید قابل مشاهده است.

JSON · Long Entry — قالب JSON برای پیام ورود خرید. قابل ویرایش است و پلیس‌هولدرها در تولتیپ Webhook JSON Format فهرست شده‌اند.

JSON · Short Entry — قالب JSON برای پیام ورود فروش. قابل ویرایش است و پلیس‌هولدرها در تولتیپ Webhook JSON Format فهرست شده‌اند.

JSON · Long Exit — قالب JSON برای پیام خروج از خرید. قابل ویرایش است و پلیس‌هولدرها در تولتیپ Webhook JSON Format فهرست شده‌اند.

JSON · Short Exit — قالب JSON برای پیام خروج از فروش. قابل ویرایش است و پلیس‌هولدرها در تولتیپ Webhook JSON Format فهرست شده‌اند.

Text · Long Entry — قالب متنی برای پیام ورود خرید. قابل ویرایش است و پلیس‌هولدرها در تولتیپ Webhook JSON Format فهرست شده‌اند.

Text · Short Entry — قالب متنی برای پیام ورود فروش. قابل ویرایش است و پلیس‌هولدرها در تولتیپ Webhook JSON Format فهرست شده‌اند.

Text · Long Exit — قالب متنی برای پیام خروج از خرید. قابل ویرایش است و پلیس‌هولدرها در تولتیپ Webhook JSON Format فهرست شده‌اند.

Text · Short Exit — قالب متنی برای پیام خروج از فروش. قابل ویرایش است و پلیس‌هولدرها در تولتیپ Webhook JSON Format فهرست شده‌اند.

Preview Messages in Pine Logs — هر چهار پیام را همان‌طور که ارسال می‌شوند (با مقادیر آخرین کندل تاریخی) در Pine Logs می‌نویسد و secret را با  ماسک می‌کند. برای تست قالب بدون انتظار برای سیگنال استفاده می‌شود.

Bull — رنگ سبز برای پس‌زمینه‌ی برچسب‌های ورود خرید، برچسب‌های خروج برنده و جعبه‌های معامله‌ی برنده.

Bear — رنگ قرمز برای پس‌زمینه‌ی برچسب‌های ورود فروش، برچسب‌های خروج بازنده و جعبه‌های معامله‌ی بازنده.

Range — رنگ آبی برای جعبه‌ی محدوده‌ی روزانه، مرزهای آن و برچسب‌های محدوده.