آموزش Pine Script برای فارکس: ساخت اندیکاتور و آلارم در TradingView

مقدمه و مبانی Pine Script

Pine Script زبان تخصصی TradingView است که برای ایجاد اندикاتورهای سفارشی، استراتژی‌ها و آلارم‌های معاملاتی استفاده می‌شود. در نسخه پنجم این زبان، امکاناتی مانند ورودی‌های پویا، توابع سریالی، عملیات ریاضی و کار با داده‌های زمانی به شکل بهینه‌تری در دسترس است. برای فارکس، Pine Script به شما امکان می‌دهد با استفاده از قیمت‌های بسته شدن (close)، قیمت‌های باز (open) و سایر داده‌های بازار، شاخص‌های فنی را پیاده‌سازی کنید و برای رویدادهای خاص مانند تقاطع خطوط میانگین متحرک یا سطح RSI، اعلان‌های سفارشی بسازید. کار با تابع security برای گرفتن داده‌های بازه‌های زمانی دیگر و ترکیب آنها با داده‌های ساختگی شما را قادر می‌سازد تا استراتژی‌ها و اندیکاتورهای چندزمانه (multi-timeframe) را پیاده‌سازی کنید.

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

• نوع کارکرد: اندیکاتور (indicator) یا استراتژی (strategy) در Pine Script. اندیکاتورها فقط نمودار را نشان می‌دهند و اعلان‌ها را از طریق تابع alertcondition یا alert ایجاد می‌کنند؛ استراتژی‌ها قابلیت معامله‌سازی و شبیه‌سازی معاملات را دارند.
• ورودی‌ها و پارامترها: از input، input.int یا input.float برای تعریف تنظیمات کاربر استفاده کنید تا کاربر بتواند دوره، سطح‌ها و سایر پارامترها را تغییر دهد.
• توابع شاخص پایه: ta.ema، ta.sma، ta.rsi، ta.macd و غیره برای محاسبات شاخص‌های متداول استفاده می‌شوند.
• رابط کاربری و گرافیک: plot، plotshape، label، bgcolor و سایر ابزارهای رسم برای نمایش دقیق‌تر داده‌ها به کار می‌روند.
• داده‌های فارکس در TradingView: اغلب با نمادهایی مانند EURUSD، GBPUSD و غیره نمایش داده می‌شود و امکان استفاده از بازه‌های زمانی مختلف وجود دارد.

مثال سادهٔ زیر نشان می‌دهد چگونه اندیکاتور را با یک ورودی برای دوره و محاسبهٔ میانگین متحرک اضافه کنید:

آشنایی با فارکس و دیتاهای TradingView

بازار فارکس با جفت ارزها معامله می‌شود و داده‌های آن معمولاً با نمادهایی مانند EURUSD یا GBPUSD نمایش داده می‌شود. در TradingView، بازه‌های زمانی متنوعی از 1 دقیقه تا سلمان‌های بالا پشتیبانی می‌شوند و شما می‌توانید از طریق منوی تایم‌فریم بازه‌های مناسب استراتژی یا اندیکاتور خود را انتخاب کنید. برای کار با فارکس در Pine Script توجه به نکات زیر مهم است:

• نمادهای فارکس معمولاً در قالب مرورگر TradingView قابل دسترس هستند و گاهی با suffixهایی مانند = یا .FX مشاهده می‌شوند؛ با اجرای اسکریپت در یک چارت فارکس، داده‌های قیمت به صورت همان اندیکاتور یا استراتژی شما در دسترس خواهند بود.
• زمان‌بندی داده‌ها: اگر قصد تحلیل چندبازه‌ای دارید، می‌توانید از تابع security برای آوردن داده‌های هم‌زمان از تایم‌فریم‌های بالاتر استفاده کنید. برای مثال می‌توانید SMA کوتاه‌مدت را با SMA بلندمدت در تایم‌فریم بالاتر مقایسه کنید.
• پوشش بازار: به خاطر روانشناسی بازار فارکس و تفاوت در ساعات معاملاتی، معمولاً تریدرها از ترکیب اندیکاتورهای فنی با مدیریت ریسک استفاده می‌کنند تا سیگنال‌ها را تصدیق کنند.

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

ساخت اندیکاتور ساده برای فارکس

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

• خط قدم اول ایجاد اسکریپت با ورژن 5 است.
• ایجاد ورودی برای دورهٔ SMA و استفاده از قیمت بسته شدن برای محاسبهٔ SMA.
• رسم SMA روی نمودار با رنگ مشخص.
• اضافه کردن شرط هشدار با استفاده از alertcondition.

کد نمونه (با استفاده از "" برای فرار از تداخل کاراکترها در JSON) به شکل زیر است:

این نسخهٔ ابتدایی به شما نشان می‌دهد چگونه ورودی‌ها را تعریف کنید، شاخص را محاسبه کنید و نتیجهٔ آن را با استفاده از plot نشان دهید. برای کاربردی‌تر کردن آن در فارکس، می‌توانید با ترکیب SMA با RSI یا MACD و افزودن فیلترهای دیگری مانند حجم یا دورهٔ زمانی مختلف، استراتژی خود را گام به گام گسترش دهید.

افزودن آلارم‌ها و شرایط هشدار

تنظیم آلارم در TradingView یکی از قدرتمندترین ابزارهاست تا به محض رخ دادن یک رویداد، اعلان‌ها به شما ارسال شوند. Pine Script امکانات مختلفی برای این کار در اختیار می‌گذارد:

• alertcondition: شرط هشدار را در قالب یک شرط شرطی تعریف می‌کند تا شما بتوانید در زمان وقوع به صورت اتوماتیک اعلان دریافت کنید.
• alert: برای ایجاد اعلان در زمان اجرای شرط
• پیام‌های متنی پویا با استفاده از مقدارهایی مانند close، high، low و یا رشته‌های ساخته‌شده با tostring

نمونهٔ کد برای اضافه کردن آلارم به شرط تقاطع قیمت با SMA:

تمدید پیام آلارم با استفاده از تابع alert به شما امکان می‌دهد اطلاعاتی مانند مقدار قیمت را به صورت داینامیک در پیام‌ها نمایش دهید. نکته مهم این است که آلارم‌ها در TradingView به عنوان هشدارهای قابل تنظیم در وب‌سایت یا اپلیکیشن اجرا می‌شوند و نیازمند فعال‌سازی کاربر در چارت هستند.

نمونه‌های اندیکاتور محبوب برای فارکس

برخی از اندیکاتورهای پرکاربرد در معاملات فارکس عبارتند از RSI، MACD، و ترکیباتی مثل کراس اوور SMA-EMA. در ادامه سه نمونهٔ عملی را بررسی می‌کنیم تا با روند توسعهٔ آنها آشنا شوید.

1) RSI با سطح‌های خروج و ورود

2) MACD پایه

3) کراس اوور میانگین‌های متحرک دوگانه

این نمونه‌ها به شما نشان می‌دهند چگونه با ترکیب پارامترها و شاخص‌های مختلف، استراتژی یا اندیکاتورهای کاربردی برای بازار فارکس بسازید. برای هر کدام، با استفاده از ورودی‌ها، توابع شاخص و هشدارها می‌توانید تجربهٔ معاملاتی خود را بهبود دهید.

راهنمای بهینه‌سازی و کارایی کد

بهینه‌سازی کد در Pine Script به معنی کاهش مصرف منابع، جلوگیری از درخواست‌های اضافی و افزایش کارایی است. برخی نکات کلیدی:

• نسخهٔ زبان: همیشه از آخرین نسخهٔ Pine Script (v5) استفاده کنید تا از بهبودها و امکانات جدید بهره‌مند شوید.
• ورودی‌های محدود: ورودی‌های کاربر را تنها به تعداد لازم تعریف کنید تا مصرف داده کاهش یابد.
• کاهش به‌روزرسانی‌های غیرضروری: از محاسبات سنگین در هر کندل خودداری کنید؛ از شرط‌های ساده برای جلوگیری از اجرای تکراری استفاده کنید.
• استفاده از security با احتیاط: برای داده‌های بازهٔ زمانی دیگر از security استفاده می‌کنید؛ اما هرچه بیشتر از آن استفاده کنید، درخواست‌های منابع بیشتر می‌شود. از caching یا caching-like patterns استفاده کنید.
• پوشش داده‌ها: اگر نیاز دارید با داده‌های تاریخی کار کنید، از bar magnitudes (volatility) یا مختصات ساده برای کاهش پیچیدگی استفاده کنید.
• خوانایی کد: از نام‌های واضح برای متغیرها استفاده کنید و توابع را به بخش‌های کوچکتر تقسیم کنید تا نگهداری ساده باشد.

نمونه‌ای از بهینه‌سازی می‌تواند شامل محاسبهٔ یک شاخص در یک شرط ساده باشد تا از اجرای مکرر جلوگیری شود. همچنین با ترکیب تابع ta.change برای تشخیص تغییرات قیمت به جای محاسبات پیچیده می‌توانید کارایی را افزایش دهید.

اشکال‌زدایی و دیباگ در Pine Script

دیباگ کد Pine Script با استفاده از ابزارهای داخلی مانند plot، label و debug-friendly patterns امکان‌پذیر است. نکات زیر می‌تواند به شما در اشکال‌زدایی کمک کند:

• استفاده از plot برای نشان دادن مقدارهای متغیرها در هر کندل برای درک رفتار آن‌ها
• استفاده از label برای نمایش مقادیر خاص روی نمودار
• استفاده از پیکربندی‌های ورودی برای تعیین حالت‌های مختلف کد
• تست کد با داده‌های تاریخی (backtesting) در یک حساب دمو قبل از استفاده در حساب واقعی

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

در این مثال با استفاده از label مقدار تفاضل قیمت و SMA نمایش داده می‌شود تا رفتار هم‌پوشانی را بررسی کنید.

گام‌های عملی: پروژه کامل ساخت اندیکاتور و آلارم

این بخش یک پروژهٔ عملی بلندمدت را ارائه می‌دهد تا بتوانید از صفر تا صد یک اندیکاتور فارکس با آلارم را بسازید. هدف پروژه ایجاد یک مولتی-تی‌فریم (multi-timeframe) ساده است که برای تایم فریم فعلی و بالاتر از آن محاسبهٔ SMA و RSI را انجام دهد و در نهایت هشدارهای قابل اعتماد ارائه کند.

1. انتخاب نماد فارکس: EURUSD یا هر جفت ارزی که به آن علاقه دارید، در چارت TradingView باز کنید.
2. پیاده‌سازی ورودی‌ها: دورهٔ SMA کوتاه و بلند، دورهٔ RSI، تایم‌فریم بالاتر، و گزینه‌های فعال‌سازی آلارم
3. محاسبهٔ SMA برای هر تایم‌فریم: از ta.sma تنها روی قیمت close استفاده کنید؛ برای تایم‌فریم بالاتر از security برای آوردن داده‌های بالاتر استفاده کنید.
4. ایجاد شروط تجمیعی: کراس اوور SMA کوتاه با SMA بلند، یا RSI-cross برای خروج از محدودهٔ اشباع خرید/فروش.
5. اضافه کردن آلارم‌ها: با alertcondition برای شروط اصلی و با alert برای پیام‌های داینامیک.
6. آزمایش با داده‌های تاریخی و بهبود استراتژی: از ویژگیٔ backtest در Pine Script برای استنتاج نتایج استفاده کنید.
7. مستندسازی و انتشار: توضیح ورودی‌ها، محدودیت‌ها و نحوه استفاده از اسکریپت در فایل README و توضیحات TradingView.

مثالی کوتاه از ترکیب تایم‌فریم پایین با بالاتر و هشدار کراس‌رُخ:

در این نمونه از security برای سیر دادهٔ بالاتر استفاده شده است. این کار به شما اجازه می‌دهد استراتژی‌ٔ چندبازه‌ای بسازید، اما با دقت در مصرف منابع و نرخ بروزرسانیٔ داده‌ها عمل کنید.

منابع و ابزارهای کمکی

برای توسعهٔ دقیق‌تر و بهبود مهارت‌ها، از منابع زیر استفاده کنید:

• مستندات رسمی Pine Script v5 و معرفی توابع TA
• دفترچهٔ راهنمای TradingView دربارهٔ ورودی‌ها، هشدارها و انتشار اسکریپت
• مثال‌های جامعهٔ کاربری در پلتفرم TradingView
• مباحث مدیریت ریسک و طراحی استراتژی‌های فارکس
• ابزارهای تست و دیباگ روی دیتاهای تاریخی جهت اطمینان از کارکرد واقعی

یادداشت: با مطالعهٔ کدهای نمونه و ایجاد پروژه‌های کوچک به تدریج به سطحی می‌رسید که بتوانید استراتژی‌های پیچیده‌تر را با آلارم‌های دقیق و قابل تنظیم پیاده‌سازی کنید. همچنین پشتیبانی از سهولت استفاده و کاربرپسندی ورودی‌ها و پیام‌های هشدار می‌تواند تجربهٔ معاملاتی شما را بهبود دهد.