تریدپدیادانشنامهٔ تریدآکا

پاین اسکریپت چیست؟ زبان تریدینگ‌ویو برای اندیکاتور

اشتراک‌گذاری:

پاین اسکریپت زبانی است که تریدینگ‌ویو برای ساخت اندیکاتور و استراتژی روی نمودارهای خودش ساخته است. ساده است که آن را فقط ابزار کشیدن یک خط روی نمودار ببینید، اما همین زبان تعیین می‌کند کد روی کندل‌های گذشته چطور اجرا شود و روی کندل زنده چطور؛ اگر این تفاوت را ندانید، ممکن است بک‌تستی ببینید که در زمان واقعی همان رفتار را ندارد.

مسیر خواندن

این مقاله برای معامله‌گری است که می‌خواهد بداند پاین اسکریپت چه می‌سازد و چطور کار می‌کند. پس از آن می‌تواند سراغ اندیکاتور و تریدینگ‌ویو برود.

در یک نگاه

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

پاین اسکریپت چیست و روی چه پلتفرمی اجرا می‌شود؟

پاین اسکریپت (Pine Script) زبان برنامه‌نویسی خود تریدینگ‌ویو است. معامله‌گر با آن اندیکاتور، استراتژی و لایبرری (library) می‌نویسد و روی نمودار همان پلتفرم اجرا می‌کند. اسکریپت‌ها روی منابع ابری اجرا می‌شوند، پس زمان اجرا، حافظه و اندازه‌شان سقف دارد. کد روی هر کندل تاریخی یک‌بار اجرا می‌شود.

سازندهٔ این زبان خود تریدینگ‌ویو است. هدف این زبان آن است که معامله‌گر ابزار تحلیلی خودش را بسازد: یک اندیکاتور تازه، نسخهٔ تغییریافتهٔ یک اندیکاتور شناخته‌شده، یا قاعده‌ای که معامله را روی دادهٔ گذشته شبیه‌سازی کند. مستندات رسمی در برداشت اکتبر ۲۰۲۶ بر پایهٔ نسخهٔ ۶ زبان نوشته شده بودند و مثال‌های این صفحه هم از همان نسخه‌اند.

تفاوت اصلی پاین با زبان‌های همه‌منظوره در محل اجراست. به گفتهٔ مستندات تریدینگ‌ویو، پاین زبانی ابری (cloud-based) است و با زبان‌های سمت کاربر (client-side) فرق دارد. یعنی کد شما روی منابع محاسباتی ابری پلتفرم اجرا می‌شود، نه روی رایانهٔ خودتان. به همین دلیل پلتفرم بر چند محور سقف می‌گذارد: دادهٔ درخواستی از نمادهای دیگر، زمان اجرا، حافظه و اندازهٔ اسکریپت.

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

با پاین اسکریپت چه چیزی می‌سازید: اندیکاتور، استراتژی یا لایبرری؟

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

اندیکاتور (indicator) مقداری را از دادهٔ نمودار حساب و رسم می‌کند و منطق سفارش ندارد. استراتژی (strategy) منطق سفارش دارد؛ به تعریف مستندات، اسکریپتی تخصصی است که معامله را روی کندل‌های تاریخی و زنده شبیه‌سازی می‌کند. به همین دلیل بک‌تست و فوروارد‌تست را ممکن می‌کند. بک‌تست یعنی اجرای قاعده روی دادهٔ گذشته. فوروارد‌تست یعنی ادامهٔ همان شبیه‌سازی روی کندل‌های زنده‌ای که پس از افزودن اسکریپت شکل می‌گیرند. لایبرری تابع‌هایی را نگه می‌دارد که اسکریپت‌های دیگر فراخوانی می‌کنند.

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

سه نوع اسکریپت پاین به تعریف مستندات تریدینگ‌ویو

نوعکار اصلیمنطق سفارشبک‌تست
اندیکاتور (indicator)محاسبه و رسم روی نمودارنداردندارد
استراتژی (strategy)شبیه‌سازی معامله روی کندل تاریخی و زندهدارددارد، همراه فوروارد‌تست
لایبرری (library)نگه‌داشتن تابع برای اسکریپت‌های دیگرنداردندارد

در هر سه نوع، ابزار اصلی شما توابع درون‌ساخت است. توابعی مثل ta.sma، ta.ema، ta.macd، ta.rsi و ta.supertrend در فضای نام ta قرار دارند و ta مخفف technical analysis است. فضای نام (namespace) پیشوندی است که تابع‌های هم‌خانواده را کنار هم نگه می‌دارد. ورودی قیمت یا حجم این توابع معمولاً یکی از متغیرهای درون‌ساخت است: open، high، low، close، hl2، hlc3، ohlc4 و volume. برای نمونه، در ta.sma(close, length) متغیر close قیمت بسته‌شدن هر کندل است و نقش پارامتر source را دارد.

اسکریپت چطور روی هر کندل اجرا می‌شود؟

پاین کد شما را برخلاف یک برنامهٔ معمولی فقط یک‌بار از بالا تا پایین اجرا نمی‌کند، بلکه به‌ازای هر کندل دوباره اجرا می‌کند. به گفتهٔ مستندات مدل اجرا، وقتی اسکریپت را به نمودار اضافه می‌کنید، کد برای هر کندل از دادهٔ موجود یک‌بار اجرا می‌شود؛ از قدیمی‌ترین کندل شروع می‌کند و به جدیدترین می‌رسد.

حاصل هر اجرا در یک سری زمانی (time series) ذخیره می‌شود. سری زمانی رشته‌ای از مقدارهاست که برای هر کندل یک خانه دارد. با عملگر [1] به مقدار کندل قبلی همان سری دسترسی دارید؛ مثلاً close[1] قیمت بسته‌شدن کندل پیشین است.

رفتار کندل آخر فرق دارد. کندلی که هنوز بسته نشده کندل زنده (realtime) است و اسکریپت روی آن با هر تغییر قیمت دوباره اجرا می‌شود. خلاصهٔ این سازوکار:

  • کندل تاریخی: یک اجرا به‌ازای هر کندل، با مقدارهای نهایی همان کندل.
  • کندل زنده: اجرای مکرر با هر تیک تا لحظهٔ بسته‌شدن کندل.
  • ثبت در سری: از کندل زنده فقط مقدار تیک پایانی وارد سری زمانی داخلی می‌شود.
  • پس از بارگذاری دوباره: مقدارهای تیک‌های میانی دیگر در دسترس نیستند.

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

یک اندیکاتور ساده چه شکلی است و از کجا نوشته می‌شود؟

کد را در ویرایشگر پاین (Pine Editor) می‌نویسید، یعنی محیط نوشتن اسکریپت در خود تریدینگ‌ویو. در مثال مستندات، اسکریپت با یک خط حاشیه‌نویسی شروع می‌شود: ⁦//@version=6⁩. این خط به کامپایلر می‌گوید اسکریپت با نسخهٔ ۶ نوشته شده است. کامپایلر برنامه‌ای است که کد را به دستور قابل اجرا تبدیل می‌کند. خط بعد نوع اسکریپت را اعلام می‌کند؛ در همان مثال، indicator("MACD #1") اسکریپت را اندیکاتور معرفی می‌کند و عنوانش را می‌گذارد.

بدنهٔ همین مثال رسمی اندیکاتور MACD را با میانگین متحرک نمایی (EMA) می‌سازد. نقش هر خط:

  1. ⁦fast = 12⁩ و ⁦slow = 26⁩: طول دو میانگین را در متغیر نگه می‌دارد تا تغییرشان فقط در یک جا لازم باشد.
  2. ⁦fastMA = ta.ema(close, fast)⁩: میانگین متحرک نمایی ۱۲ دوره روی قیمت بسته‌شدن.
  3. ⁦slowMA = ta.ema(close, slow)⁩: همان محاسبه با ۲۶ دوره.
  4. ⁦macd = fastMA - slowMA⁩: خط MACD تفاوت این دو میانگین است.
  5. ⁦signal = ta.ema(macd, 9)⁩: خط سیگنال میانگین نمایی ۹ دورهٔ خود خط MACD است.
  6. ⁦plot(macd, color = color.blue)⁩ و ⁦plot(signal, color = color.orange)⁩: هر دو خط را با رنگ آبی و نارنجی روی نمودار رسم می‌کند.

این چند خط سازوکار زبان را خلاصه می‌کند. چون محاسبه روی هر کندل تکرار می‌شود، fastMA، slowMA و macd همگی سری‌اند و برای هر کندل مقدار خودشان را دارند. ورودی ta.ema در خط دوم close است، اما در خط پنجم خود macd است؛ یعنی خروجی یک تابع می‌تواند ورودی تابع بعدی باشد. ta.macd هم تابع درون‌ساخت همین اندیکاتور است و نسخهٔ دستی برای دیدن ساختار کد است.

نکته

این کد عدد بازار نمی‌دهد

مثال بالا ساختار کد است، نه داده یا نتیجهٔ بازار. خروجی آن به نماد و تایم‌فریم نموداری بستگی دارد که اسکریپت را رویش می‌گذارید، و عددهای ۱۲، ۲۶ و ۹ فقط ورودی‌های مثال مستندات‌اند، نه تنظیم پیشنهادی.

ریپینت چیست و چرا نتیجه بک‌تست را بی‌اعتبار می‌کند؟

ریپینت (repainting) طبق تعریف مستندات تریدینگ‌ویو رفتاری از اسکریپت است که باعث می‌شود محاسبه یا رسم روی کندل‌های تاریخی با کندل زنده فرق کند. به زبان ساده، نموداری که پس از بارگذاری دوباره می‌بینید با چیزی که اسکریپت در زمان واقعی نشان داده بود یکی نیست.

سازوکار اول همان است که در مدل اجرا دیدید. اگر استراتژی را با ⁦calc_on_every_tick = true⁩ بنویسید، استراتژی روی کندل زنده با هر تیک محاسبه می‌کند. اما در محاسبهٔ پیش‌فرض تاریخچه چنین تیک‌هایی وجود ندارد. به گفتهٔ مستندات، اگر این تفاوت رخ دهد، نتیجهٔ بک‌تست هم بی‌اعتبار می‌شود، چون رفتار استراتژی در زمان واقعی را نمایندگی نمی‌کند.

سازوکار دوم نشت داده از آینده است. تابع request.security() دادهٔ یک نماد یا تایم‌فریم دیگر را به اسکریپت می‌آورد. نشت آینده در درخواست تایم‌فریم بالاتر رخ می‌دهد. اگر چنین درخواستی را با barmerge.lookahead_on صدا بزنید و سری درخواستی را با [1] یک کندل عقب نبرید، تابع روی کندل‌های تاریخی مقدارهایی برمی‌گرداند که در آن لحظه هنوز وجود نداشته‌اند. نمونه‌اش قیمت بسته‌شدن روزی است که هنوز تمام نشده است. حاصل نموداری است که گذشته را دقیق‌تر از توان واقعی اسکریپت نشان می‌دهد. مستندات این رفتار را گمراه‌کننده می‌داند و استفادهٔ گمراه‌کننده از lookahead در انتشار اسکریپت مجاز نیست.

هشدار

بک‌تست ریپینت‌شده تصویر واقعی نیست

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

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

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

  1. تکیه بر کندل در حال شکل‌گیری: شرطی که میانهٔ کندل زنده برقرار می‌شود ممکن است تا بسته‌شدن کندل از بین برود. شرطی را که تصمیم بر آن بنا می‌شود روی کندل بسته‌شده بسنجید.
  2. استفاده از lookahead_on بدون [1]: این همان نشت آینده در بخش ریپینت است و در اسکریپت‌هایی رخ می‌دهد که دادهٔ تایم‌فریم بالاتر را با request.security() می‌آورند.
  3. قضاوت دربارهٔ استراتژی از روی نمودار غیراستاندارد: روی نمودارهایی مثل هایکن‌آشی، قیمت هر کندل از محاسبه به دست می‌آید و قیمت واقعی بازار نیست. استراتژی روی این نمودار با همین قیمت‌های مصنوعی معامله را شبیه‌سازی می‌کند و به گفتهٔ مستندات معمولاً نتیجهٔ غیرواقعی می‌دهد.

خطای سوم یک لایهٔ پنهان هم دارد. شبیه‌ساز کارگزار (broker emulator) به‌طور پیش‌فرض سفارش‌های استراتژی را فقط با دادهٔ موجود نمودار پر می‌کند. پس اگر خود نمودار قیمت مصنوعی نشان دهد، قیمت پرشدن سفارش‌ها در گزارش هم مصنوعی است.

محدودیت‌های پاین اسکریپت چیست؟

همهٔ این سقف‌ها از ابری‌بودن پاین اسکریپت می‌آیند: پلتفرم منابع محاسباتی را اداره می‌کند و برای هر اسکریپت حد می‌گذارد. جدول زیر سقف‌های اعلام‌شده در صفحهٔ محدودیت‌های مستندات را کنار هم می‌گذارد.

سقف‌ها به نقل از صفحهٔ محدودیت‌های مستندات تریدینگ‌ویو، برداشت اکتبر ۲۰۲۶

محورسقفمعنای عملی
زمان کامپایل۲ دقیقهتبدیل کد به نسخهٔ اجرایی
زمان اجرای اسکریپت۲۰ ثانیه برای حساب پایه، ۴۰ ثانیه برای سایر حساب‌هاکل محاسبه روی همهٔ کندل‌ها
رسم۶۴ شمارش plot در هر اسکریپتخروجی‌های رسم‌شده
بافر تاریخچه۵۰۰۰ کندل برای بیشتر سری‌هادورترین ارجاع با عملگر []

سقف زمان اجرا کل محاسبه را می‌سنجد، نه یک کندل را. حلقه‌ای سبک روی تاریخچهٔ کوتاه مشکلی ندارد، ولی همان حلقه روی تاریخچهٔ بلند ممکن است به سقف برسد. بافر تاریخچه هم تعیین می‌کند با عملگر [] تا چند کندل عقب می‌توانید ارجاع دهید.

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

از کجا شروع کنید و نسخه ۶ چه تغییرهایی دارد؟

گام اول ساده است: ویرایشگر پاین را باز کنید، با ⁦//@version=6⁩ و یک فراخوانی indicator شروع کنید و مثال MACD را خط‌به‌خط بازسازی کنید. مرجع گام بعد صفحه‌های مدل اجرا و ریپینت در مستندات است، چون خطاهای رایج از همین مفهوم‌ها می‌آیند.

اگر کد یا آموزشی قدیمی‌تر می‌خوانید، بدانید پیش‌فرض‌های نسخهٔ ۶ فرق کرده است:

  • درخواست‌های پویا (dynamic requests) به‌طور پیش‌فرض فعال‌اند؛ یعنی فراخوانی request.*() با آرگومان متغیر و درون شرط یا حلقه ممکن است.
  • مقدار bool دیگر نمی‌تواند na (مقدار تهی) باشد و فقط true یا false است.
  • شرط‌های and و or تنبل (lazy) ارزیابی می‌شوند: اگر بخش اول نتیجه را معلوم کند، بخش دوم محاسبه نمی‌شود.
  • درصد مارجین پیش‌فرض استراتژی ۱۰۰ است؛ یعنی شبیه‌ساز برای هر پوزیشن کل ارزش آن را از سرمایهٔ حساب کنار می‌گذارد.

زبان پس از نسخهٔ ۶ هم به‌تدریج تغییر می‌کند؛ برای نمونه، استراتژی‌ها پارامتر calc_on_every_history_tick را هم به دست آوردند. کد نسخه‌های قدیمی‌تر را پیش از استفاده با راهنمای مهاجرت به نسخهٔ ۶ تطبیق دهید.

یک تذکر لازم

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

پرسش‌های پرتکرار

پاین اسکریپت را از کجا شروع کنم؟
از ویرایشگر پاین (Pine Editor) شروع کنید؛ محیط نوشتن اسکریپت در تریدینگ‌ویو همین است. اسکریپت تازه را با خط ⁦//@version=6⁩ و فراخوانی indicator همراه یک عنوان باز کنید. سپس مثال MACD مستندات را بنویسید و ورودی‌های ۱۲، ۲۶ و ۹ را عوض کنید تا ببینید خروجی روی نمودار چطور تغییر می‌کند. پس از آن، مدل اجرا روی هر کندل را بخوانید.
آیا برای یادگیری پاین اسکریپت باید برنامه‌نویس باشم؟
دانش برنامه‌نویسی کمک می‌کند، ولی برای شروع شرط نیست. مثال MACD مستندات چند خط انتساب ساده است: متغیرهایی مثل fast و slow، تابع‌های آماده‌ای مثل ta.ema و متغیر قیمتی close به‌عنوان ورودی. بخش دشوار پاین معمولاً نحو زبان نیست؛ فهم سری زمانی و اجرای کد روی هر کندل است که تفاوت کندل تاریخی و زنده را توضیح می‌دهد.
پاین اسکریپت با پایتون فرق دارد؟
بله. پایتون زبانی همه‌منظوره است که معمولاً روی رایانهٔ خود شما اجرا می‌شود، اما پاین اسکریپت زبان خود تریدینگ‌ویو است و روی منابع ابری همین پلتفرم اجرا می‌شود. مدل اجرای پاین هم متفاوت است: کد روی هر کندل تاریخی یک‌بار و روی کندل زنده با هر تغییر قیمت بارها اجرا می‌شود و نتیجه به‌شکل سری زمانی می‌ماند. ابری‌بودن، سقف زمان اجرا، حافظه و اندازه را هم با خود می‌آورد.

واژه‌های این مقاله

منابع

این مقاله با کمکِ ابزارهای هوش مصنوعی تهیه شده است. سیاست تحریریه

دیدگاه خود را ارسال کن

ارسال دیدگاه

مطالب مرتبط

دیدگاه‌ها (۰)

هنوز دیدگاهی ثبت نشده؛ اولین نفر باش.

ارسال دیدگاه

دیدگاه‌ها پیش از انتشار بررسی می‌شوند. به پرسش‌های معاملاتی پاسخ نمی‌دهیم و سیگنال نمی‌دهیم.

دوره‌های آموزش تریدآکا

دورهٔ بعدی یادگیری‌ات را پیدا کن

دوره‌ها را ببین، سبک‌ها را مقایسه کن و آموزش مناسب خودت را انتخاب کن.

مشاهده همه دوره‌ها
ادامهٔ مسیر تو

قدم بعدی را انتخاب کن

مسیر یادگیریت را پیدا کن

راهنمای شروع، انتخاب سبک و ترتیب یادگیری دوره‌ها را متناسب با هدفت ببین.

دیدن مسیر یادگیری

سبک معامله‌گریت را بشناس

با تست Trader DNA، الگوی تصمیم‌گیری و سبک‌های نزدیک‌تر به خودت را بشناس.

شناخت DNA معاملاتی

مقایسهٔ پلن‌ها

پوشش دوره‌ها و شرایط اشتراک طلایی و الماس را کنار هم مقایسه کن.