پاین اسکریپت: اولین اندیکاتور ICT خود را کدنویسی کنید

تصور کنید که از میان هیاهوی نمودارهای فارکس عبور می‌کنید، نه با تحلیل‌های دستی بی‌پایان، بلکه با ابزاری سفارشی که ستاپ‌های ICT با احتمال موفقیت بالا را برای شما برجسته می‌کند. بسیاری از معامله‌گران سطح متوسط، قدرت مفاهیم ICT مانند شکاف‌های ارزش منصفانه (Fair Value Gaps) یا اوردر بلاک‌ها (Order Blocks) را درک می‌کنند، اما با کاربرد ذهنی آن‌ها و زمان زیادی که برای شناسایی مداوم آن‌ها صرف می‌شود، دست و پنجه نرم می‌کنند. چه می‌شد اگر می‌توانستید این دقت را خودکار کنید و دانش نظری را به یک مزیت عملی و صرفه‌جویی در زمان تبدیل کنید؟ این به معنای جایگزینی تصمیمات معاملاتی شما نیست، بلکه تقویت آن‌ها با داده‌های عینی است. در این راهنما، ما این شکاف را پر خواهیم کرد و به شما نشان خواهیم داد که چگونه از پاین اسکریپت نسخه ۵ (Pine Script v5) در TradingView برای کدنویسی اولین اندیکاتور ICT خود استفاده کنید. شما یاد خواهید گرفت که شناسایی الگوهای حیاتی پرایس اکشن را خودکار کنید، زمان تحلیل را کاهش دهید و سطح جدیدی از ثبات را به استراتژی فارکس خود بیاورید. آماده شوید تا بینش‌های ICT خود را به کدی قابل اجرا تبدیل کنید.

دستیابی به دقت خودکار: پاین اسکریپت نسخه ۵ و مبانی ICT

قبل از اینکه به سراغ کدنویسی برویم، بیایید صحنه را آماده کنیم. چرا پاین اسکریپت؟ و کدام مفهوم خاص ICT را هدف قرار داده‌ایم؟ درک «چرا»ی پشت ابزارها و مفاهیم، چیزی است که یک «اسکریپت-کیدی» را از یک معامله‌گر ماهر که برتری خود را می‌سازد، متمایز می‌کند.

قدرت پاین اسکریپت نسخه ۵ برای اتوماسیون فارکس

پاین اسکریپت را به عنوان یک زبان تخصصی در نظر بگیرید که برای یک هدف ساخته شده است: ایجاد ابزارهای معاملاتی سفارشی در TradingView. این زبان طوری طراحی شده که از زبان‌های برنامه‌نویسی عمومی مانند پایتون در دسترس‌تر باشد. نسخه ۵، که تمرکز امروز ماست، سینتکس تمیزتر و ویژگی‌های قدرتمندتری را معرفی کرد که جان بخشیدن به ایده‌های معاملاتی شما را آسان‌تر از همیشه می‌کند.

مزایای کلیدی برای یک معامله‌گر ICT عبارتند از:

• عینیت: کد از قوانین پیروی می‌کند، تمام. این کار حدس و گمان‌های احساسی مانند «آیا این واقعاً یک FVG است؟» را از تحلیل شما حذف می‌کند.
• کارایی: یک اندیکاتور می‌تواند هر کندل را برای یافتن یک ستاپ در میلی‌ثانیه اسکن کند، کاری که ساعت‌ها اسکرول دستی از شما زمان می‌برد.
• بک‌تست: پس از کدنویسی، می‌توانید به صورت بصری ارزیابی کنید که ستاپ‌های خاص شما در گذشته چند بار ظاهر شده‌اند، که به شما درک بهتری از فراوانی و رفتار آن‌ها می‌دهد.

اگر کدهای قدیمی‌تر پاین اسکریپت را دیده‌اید، نسخه ۵ همه چیز را بسیار واضح‌تر کرده است. به عنوان مثال، توابع اختصاصی برای ترسیم (box.new()، line.new()) معرفی کرد و نحوه تعریف متغیرها (var) را بهبود بخشید، که اسکریپت‌ها را قوی‌تر و خواناتر می‌کند.

رمزگشایی از مفاهیم کلیدی ICT: شکاف‌های ارزش منصفانه (FVG)

ما با یکی از اساسی‌ترین مفاهیم ICT شروع می‌کنیم: شکاف ارزش منصفانه (FVG). این یک کاندیدای عالی برای اتوماسیون است زیرا تعریف واضح و مبتنی بر قانون دارد.

یک FVG یک الگوی سه-کندلی است که نشان‌دهنده ناکارآمدی یا عدم تعادل در بازار است. قیمت آنقدر سریع در یک جهت حرکت کرده که یک «شکاف» در عرضه بازار به جا گذاشته است.

• FVG صعودی (یا BISI - Buyside Imbalance Sellsise Inefficiency): کف (low) کندل سوم بالاتر از سقف (high) کندل اول است. شکاف، فضای بین سقف کندل اول و کف کندل سوم است.
• FVG نزولی (یا SIBI - Sellside Imbalance Buyside Inefficiency): سقف (high) کندل سوم پایین‌تر از کف (low) کندل اول است. شکاف، فضای بین کف کندل اول و سقف کندل سوم است.

این نواحی اغلب مانند آهنربا برای قیمت عمل می‌کنند و قیمت تمایل دارد برای «تعادل مجدد» پرایس اکشن ناکارآمد، به آن‌ها بازگردد. برای بررسی عمیق‌تر انواع مختلف شکاف‌های بازار، راهنمای ما در مورد تسلط بر ۳ نوع شکاف ICT را بررسی کنید. در حال حاضر، این الگوی ساده و قدرتمند تمام چیزی است که برای شروع کدنویسی نیاز داریم.

بوم کدنویسی شما: راه‌اندازی TradingView برای اتوماسیون ICT

آماده‌اید دست به کار شوید؟ بیایید کارگاه را باز کنیم. TradingView این کار را فوق‌العاده آسان می‌کند. نیازی به نصب هیچ نرم‌افزاری ندارید؛ همه چیز درست در مرورگر شما اتفاق می‌افتد.

پیمایش در رابط کاربری Pine Editor

در پایین نمودار TradingView خود، یک تب با عنوان «Pine Editor» خواهید دید. روی آن کلیک کنید. اینجا مرکز فرماندهی شماست. ممکن است کمی ترسناک به نظر برسد، اما ساده است.

۱. باز کردن ویرایشگر: روی تب «Pine Editor» کلیک کنید.
۲. ایجاد یک اسکریپت جدید: روی «Open» کلیک کرده و «New blank indicator» را انتخاب کنید.

TradingView ویرایشگر را با چند کد اولیه پر می‌کند. بیایید آن را بررسی کنیم.

سینتکس و ساختار ضروری پاین اسکریپت نسخه ۵

هر اندیکاتور پاین اسکریپت نسخه ۵ چند جزء اصلی دارد. این الگوی پیش‌فرضی است که خواهید دید:

//@version=5
indicator("My script")
plot(close)

• //@version=5: این خط اجباری است. به TradingView می‌گوید که از آخرین نسخه زبان استفاده کند.
• indicator("My script"): این تابع اسکریپت شما را به عنوان یک اندیکاتور تعریف می‌کند. می‌توانید نام داخل گیومه را به چیزی مانند «My ICT FVG Finder» تغییر دهید. تنظیم overlay=true در داخل پرانتز (indicator("My FVG", overlay=true)) باعث می‌شود ترسیمات شما به جای یک پنل جداگانه در پایین، روی نمودار اصلی ظاهر شوند.
• plot(close): این یک تابع ساده است که نمودار خطی قیمت پایانی هر کندل را ترسیم می‌کند. ما این را حذف کرده و آن را با منطق و ترسیمات سفارشی خود جایگزین خواهیم کرد.

برای ساخت ردیاب FVG خود، به دو مفهوم دیگر نیاز داریم:

• متغیرها: برای ذخیره داده‌ها. به عنوان مثال، is_bullish_fvg = low[2] > high. در اینجا، [2] به داده‌های دو کندل قبل اشاره دارد. high (یا high[0]) به کندل فعلی و در حال توسعه اشاره دارد.

• منطق شرطی: برای تصمیم‌گیری. ما از یک عبارت if استفاده خواهیم کرد: if is_bullish_fvg... سپس کاری انجام بده، مانند کشیدن یک جعبه روی نمودار.

این تمام چیزی بود که برای راه‌اندازی نیاز داشتیم. حالا، بیایید منطق را بنویسیم.

از تئوری تا کد: ساخت اولین اندیکاتور ICT FVG

اینجا جایی است که جادو اتفاق می‌افتد. ما قصد داریم تعریف FVG را از زبان ساده به پاین اسکریپت ترجمه کنیم. هدف ما ایجاد یک اندیکاتور است که به طور خودکار هر FVG را شناسایی کرده و یک جعبه دور آن ترسیم کند.

شناسایی الگوهای FVG با منطق پاین اسکریپت

بیایید با یک صفحه تمیز در Pine Editor شما شروع کنیم. کد پیش‌فرض را حذف کنید و بیایید این را گام به گام بسازیم.

ابتدا، تنظیمات اولیه:

//@version=5
indicator("FXNX ICT FVG Detector", overlay=true)

سپس، شرایط را برای هر دو FVG صعودی و نزولی تعریف می‌کنیم. قانون ۳-کندلی را به خاطر بسپارید. در پاین اسکریپت، high[1] به سقف کندل قبلی، low[1] به کف کندل قبلی و غیره اشاره دارد.

// --- LOGIC --- //
// یک FVG صعودی وجود دارد اگر کف کندل فعلی بالاتر از سقف دو کندل قبل باشد.
bullish_fvg = high[2] < low

// یک FVG نزولی وجود دارد اگر سقف کندل فعلی پایین‌تر از کف دو کندل قبل باشد.
bearish_fvg = low[2] > high

نکته حرفه‌ای: این منطق high[2] و low فعلی (یا low[0]) را بررسی می‌کند. این بدان معناست که FVG تنها پس از بسته شدن کندل سوم در الگو تأیید می‌شود. خود شکاف روی کندل وسطی است که کندل [1] می‌باشد.

بصری‌سازی نواحی ICT روی نمودار شما

حالا که متغیرهای bullish_fvg و bearish_fvg را داریم، که برای هر کندل true یا false خواهند بود، می‌توانیم به اسکریپت بگوییم وقتی true هستند، چیزی ترسیم کند.

ما از یک عبارت if و تابع box.new() استفاده خواهیم کرد. این تابع یک مستطیل روی نمودار ترسیم می‌کند.

// --- DRAWING --- //
// اگر یک FVG صعودی شناسایی شد، یک جعبه سبز بکش.
if bullish_fvg
    box.new(
      left = bar_index[1], 
      top = high[2], 
      right = bar_index, 
      bottom = low, 
      bgcolor = color.new(color.green, 80), 
      border_color = color.new(color.green, 80)
      )

// اگر یک FVG نزولی شناسایی شد، یک جعبه قرمز بکش.
if bearish_fvg
    box.new(
      left = bar_index[1], 
      top = high, 
      right = bar_index, 
      bottom = low[2], 
      bgcolor = color.new(color.red, 80), 
      border_color = color.new(color.red, 80)
      )

بیایید box.new() را تجزیه کنیم:

• left و right: مختصات x (زمان). bar_index[1] شروع کندل میانی و bar_index پایان آن است.
• top و bottom: مختصات y (قیمت). برای یک FVG صعودی، جعبه از سقف کندل اول (high[2]) تا کف کندل سوم (low) امتداد دارد.

• bgcolor و border_color: ما رنگ و شفافیت را تنظیم می‌کنیم (۸۰ کاملاً شفاف است).

این هم اسکریپت کامل و آماده برای کپی-پیست:

//@version=5
indicator("FXNX ICT FVG Detector", overlay=true)

// --- LOGIC --- //
// FVG صعودی یک الگوی ۳-کندلی است که در آن شکافی بین سقف کندل اول و کف کندل سوم وجود دارد.
bullish_fvg = high[2] < low

// FVG نزولی یک الگوی ۳-کندلی است که در آن شکافی بین کف کندل اول و سقف کندل سوم وجود دارد.
bearish_fvg = low[2] > high

// --- DRAWING --- //
// اگر یک FVG صعودی در زمان بسته شدن کندل سوم شناسایی شد، یک جعبه سبز بکش.
if bullish_fvg
    box.new(
      left = bar_index[1], // شروع جعبه از کندل FVG
      top = high[2], // بالای شکاف
      right = bar_index, // پایان جعبه در کندل فعلی
      bottom = low, // پایین شکاف
      bgcolor = color.new(color.green, 80), // تنظیم رنگ پس‌زمینه و شفافیت
      border_color = color.new(color.green, 80) // تنظیم رنگ حاشیه
      )

// اگر یک FVG نزولی در زمان بسته شدن کندل سوم شناسایی شد، یک جعبه قرمز بکش.
if bearish_fvg
    box.new(
      left = bar_index[1], // شروع جعبه از کندل FVG
      top = high, // بالای شکاف
      right = bar_index, // پایان جعبه در کندل فعلی
      bottom = low[2], // پایین شکاف
      bgcolor = color.new(color.red, 80), // تنظیم رنگ پس‌زمینه و شفافیت
      border_color = color.new(color.red, 80) // تنظیم رنگ حاشیه
      )

این کد را در Pine Editor خود پیست کرده و روی «Add to Chart» کلیک کنید. تبریک می‌گویم، شما اولین اندیکاتور ICT خود را کدنویسی کردید!

بینش‌های عملی: اعمال اندیکاتور ICT بر روی نمودارهای فارکس

داشتن یک ابزار یک چیز است؛ دانستن نحوه استفاده از آن چیز دیگری است. نمودار شما اکنون با جعبه‌های سبز و قرمز پر شده است، اما این‌ها واقعاً برای معاملات شما چه معنایی دارند؟

افزودن و پیکربندی اندیکاتور سفارشی شما

هنگامی که در Pine Editor روی «Add to Chart» کلیک می‌کنید، ردیاب FVG شما روی جفت ارز فارکس انتخابی شما، مانند EUR/USD، ظاهر می‌شود. می‌توانید با کلیک بر روی نام اندیکاتور در گوشه بالا سمت چپ نمودار، نمایش آن را تغییر دهید یا به تنظیمات آن دسترسی پیدا کنید. برای این اسکریپت ساده، هنوز هیچ تنظیماتی برای پیکربندی وجود ندارد، اما اگر ورودی‌های کاربر را اضافه می‌کردید، در اینجا قرار می‌گرفتند.

تفسیر سیگنال‌ها برای فرصت‌های معاملاتی

اندیکاتور جدید شما یک نقشه از ناکارآمدی‌های بازار است، نه یک چراغ راهنمایی برای ورود به معامله. این اندیکاتور مناطقی را که باید به آن‌ها توجه بیشتری داشته باشید، برجسته می‌کند.

• FVGها به عنوان حمایت/مقاومت: FVGهای صعودی (سبز) اغلب به عنوان حمایت عمل می‌کنند. هنگامی که قیمت به داخل یک جعبه سبز باز می‌گردد، ممکن است با فشار خرید مواجه شود. برعکس، FVGهای نزولی (قرمز) می‌توانند به عنوان مقاومت عمل کنند.
• FVGها به عنوان اهداف: اگر در یک معامله فروش هستید و قیمت در حال کاهش است، یک FVG صعودی در نزدیکی می‌تواند مکانی منطقی برای برداشت سود باشد، زیرا قیمت ممکن است در آنجا متوقف یا معکوس شود.
• زمینه (Context) پادشاه است: یک FVG صعودی که در یک روند نزولی واضح ظاهر می‌شود، بسیار کمتر از FVGای که پس از یک تغییر عمده در ساختار بازار شکل می‌گیرد، قابل اعتماد است. همیشه سیگنال‌های اندیکاتور را با تحلیل گسترده‌تر خود ترکیب کنید. آیا قیمت در تایم‌فریم‌های بالاتر صعودی است یا نزولی؟ اندیکاتور شما عینیت را فراهم می‌کند، اما شما زمینه را فراهم می‌کنید. درک تعامل بین مفاهیمی مانند FVGها و سایر ساختارها کلیدی است؛ ابزاری مانند درخت تصمیم‌گیری اوردر بلاک در مقابل بریکر بلاک می‌تواند به ایجاد این آگاهی زمینه‌ای کمک کند.

هشدار: هرگز تنها بر اساس سیگنال یک اندیکاتور وارد معامله نشوید. این ردیاب FVG یک ابزار قدرتمند برای تلاقی (confluence) است که به تأیید ایده‌های معاملاتی که قبلاً توسط تحلیل کلی بازار شما پشتیبانی می‌شوند، کمک می‌کند.

فراتر از اصول اولیه: بهبود اندیکاتور ICT و بهترین شیوه‌ها

اولین اندیکاتور شما یک گام بزرگ است، اما این تنها آغاز راه است. مانند هر ابزاری، می‌توان آن را بهبود بخشید و اصلاح کرد. همچنین مهم است که از دام‌های رایج، هم در کدنویسی و هم در کاربرد، آگاه باشید.

اشتباهات رایج در کدنویسی و پیاده‌سازی ICT

۱. نادیده گرفتن زمینه: بزرگترین اشتباه این است که هر FVG را به عنوان یک ستاپ با احتمال موفقیت بالا در نظر بگیرید. FVGای که توسط یک خبر با تأثیر بالا ایجاد شده، با FVGای که در یک بازار آرام و رنج شکل گرفته، متفاوت است. کد شما نمی‌تواند اخبار را ببیند؛ شما باید ببینید.
۲. خطای نگاه به آینده (Look-Ahead Bias): یک خطای رایج در کدنویسی استفاده از داده‌های آینده است. اسکریپت ما به درستی از داده‌های تاریخی ([1]، [2]) برای تصمیم‌گیری استفاده می‌کند و اطمینان می‌دهد که «تقلب» نمی‌کند. همیشه مراجع داده خود را دوباره بررسی کنید.
۳. بهینه‌سازی بیش از حد (Over-Optimization): وسوسه‌انگیز است که ده‌ها فیلتر اضافه کنید تا یک سیگنال «کامل» ایجاد کنید. این کار اغلب منجر به یک اندیکاتور بی‌فایده می‌شود که برای داده‌های گذشته طراحی شده و در بازارهای زنده شکست می‌خورد. ساده شروع کنید و تنها زمانی که دلیل واضحی دارید، پیچیدگی را اضافه کنید. به یاد داشته باشید، کاربرد مداوم یک استراتژی خوب است که منجر به رشد مرکب بلندمدت می‌شود، نه یک اندیکاتور جادویی.

تکامل اندیکاتور شما: گام‌های بعدی برای سفارشی‌سازی

اسکریپت خود را به عنوان یک پایه در نظر بگیرید. در اینجا چند ایده برای گسترش آن وجود دارد:

• افزودن ورودی‌های کاربر: به خودتان اجازه دهید رنگ‌ها را تغییر دهید یا FVGهای صعودی/نزولی را از منوی تنظیمات با استفاده از input.color() و input.bool() روشن و خاموش کنید.
• ایجاد هشدار (Alert): از تابع alertcondition() برای دریافت اعلان هر زمان که یک FVG جدید تشکیل می‌شود، استفاده کنید تا مجبور نباشید تمام روز به نمودارها خیره شوید.
• فیلتر بر اساس اندازه: شرطی اضافه کنید تا فقط FVGهایی را نشان دهد که اندازه مشخصی بر حسب پیپ دارند و شکاف‌های کوچک و بی‌اهمیت را فیلتر کنید.
• ادغام مفاهیم دیگر: آیا می‌توانید منطق را برای شناسایی اوردر بلاک‌ها تغییر دهید؟ یا فقط FVGهایی را نشان دهید که پس از یک نقدینگی‌گیری (liquidity sweep) رخ می‌دهند؟

برای یک راهنمای جامع در مورد قابلیت‌های پاین اسکریپت، راهنمای رسمی کاربر پاین اسکریپت نسخه ۵ از TradingView یک منبع ارزشمند است. سفر به دنیای خودکارسازی تحلیل شما یک فرآیند مداوم یادگیری، آزمایش و اصلاح است.

شما به تازگی یک جهش قابل توجه در سفر معاملاتی خود داشته‌اید و از تحلیل دستی فراتر رفته‌اید تا شناسایی مفاهیم قدرتمند ICT را با استفاده از پاین اسکریپت نسخه ۵ خودکار کنید. ما اصول اولیه را پوشش دادیم، از درک قابلیت‌های پاین اسکریپت و مفاهیم اصلی ICT مانند شکاف‌های ارزش منصفانه، تا راه‌اندازی محیط توسعه و کدنویسی اولین اندیکاتور سفارشی شما. توانایی ترسیم عینی این نواحی حیاتی بر روی نمودارهای شما، ذهنیت‌گرایی را کاهش می‌دهد، در زمان ارزشمند صرفه‌جویی می‌کند و امکان تحلیل منسجم‌تری را فراهم می‌آورد. به یاد داشته باشید، اتوماسیون ابزاری برای تقویت تصمیم‌گیری شماست، نه جایگزینی آن. گام بعدی آزمایش است: پارامترها را تغییر دهید، هشدارها را اضافه کنید، یا حتی مفاهیم دیگر ICT را برای ساخت یک دستیار معاملاتی واقعاً شخصی‌سازی شده، ادغام کنید. برای منابع بیشتر و استراتژی‌های پیشرفته برای بهبود برتری معاملاتی خودکار خود، ابزارها و محتوای آموزشی جامع موجود در FXNX را کاوش کنید. خودکارسازی تحلیل ICT شما چگونه رویکرد معاملاتی شما را متحول خواهد کرد؟

همین امروز کدنویسی اولین اندیکاتور ICT خود را شروع کنید! مفاهیم ارائه شده پاین اسکریپت نسخه ۵ را در TradingView آزمایش کنید و نتایج خود را در نظرات زیر به اشتراک بگذارید. برای آموزش‌های پیشرفته‌تر پاین اسکریپت و استراتژی‌های ICT، وبلاگ FXNX را کاوش کنید.

سوالات متداول

شکاف ارزش منصفانه (FVG) در ICT چیست؟

شکاف ارزش منصفانه یا FVG، یک الگوی سه-کندلی است که نشان‌دهنده عدم تعادل در بازار است. این اتفاق زمانی رخ می‌دهد که قیمت به سرعت حرکت می‌کند و شکافی بین فتیله (wick) کندل اول و فتیله کندل سوم باقی می‌گذارد، ناحیه‌ای که قیمت ممکن است بعداً برای تعادل مجدد به آن بازگردد.

آیا یادگیری پاین اسکریپت برای معامله‌گران دشوار است؟

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

آیا می‌توانم از این اندیکاتور ICT پاین اسکریپت در MT4/MT5 استفاده کنم؟

خیر، پاین اسکریپت منحصر به پلتفرم TradingView است. MetaTrader 4 و 5 از یک زبان برنامه‌نویسی متفاوت به نام MQL4/MQL5 استفاده می‌کنند. منطق را می‌توان ترجمه کرد، اما خود کد مستقیماً سازگار نیست.

چگونه می‌توانم به اندیکاتور FVG خود هشدار اضافه کنم؟

می‌توانید از تابع alert() یا alertcondition() در پاین اسکریپت استفاده کنید. به عنوان مثال، پس از بلوک if bullish_fvg خود، می‌توانید خطی مانند alert("Bullish FVG Detected on " + syminfo.tickerid, freq = alert.freq_once_per_bar_close) اضافه کنید تا یک هشدار قابل تنظیم ایجاد کنید.