پاین اسکریپت چیست؟ زبان تریدینگویو برای اندیکاتور
پاین اسکریپت زبانی است که تریدینگویو برای ساخت اندیکاتور و استراتژی روی نمودارهای خودش ساخته است. ساده است که آن را فقط ابزار کشیدن یک خط روی نمودار ببینید، اما همین زبان تعیین میکند کد روی کندلهای گذشته چطور اجرا شود و روی کندل زنده چطور؛ اگر این تفاوت را ندانید، ممکن است بکتستی ببینید که در زمان واقعی همان رفتار را ندارد.
این مقاله برای معاملهگری است که میخواهد بداند پاین اسکریپت چه میسازد و چطور کار میکند. پس از آن میتواند سراغ اندیکاتور و تریدینگویو برود.
در یک نگاه
- پاین اسکریپت زبان برنامهنویسی تریدینگویو برای ساخت ابزار تحلیل است.
- سه نوع اسکریپت دارد: اندیکاتور، استراتژی و لایبرری.
- کد روی هر کندل تاریخی یکبار اجرا میشود.
- ریپینت میتواند نتیجهٔ بکتست را بیاعتبار کند.
- زمان اجرا، حافظه و اندازهٔ اسکریپت سقف دارند.
پاین اسکریپت چیست و روی چه پلتفرمی اجرا میشود؟
پاین اسکریپت (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) میسازد. نقش هر خط:
- fast = 12 و slow = 26: طول دو میانگین را در متغیر نگه میدارد تا تغییرشان فقط در یک جا لازم باشد.
- fastMA = ta.ema(close, fast): میانگین متحرک نمایی ۱۲ دوره روی قیمت بستهشدن.
- slowMA = ta.ema(close, slow): همان محاسبه با ۲۶ دوره.
- macd = fastMA - slowMA: خط MACD تفاوت این دو میانگین است.
- signal = ta.ema(macd, 9): خط سیگنال میانگین نمایی ۹ دورهٔ خود خط MACD است.
- 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 در انتشار اسکریپت مجاز نیست.
هشدار
بکتست ریپینتشده تصویر واقعی نیست
اگر تصمیم معاملاتی خود را بر بکتست اسکریپتی بگذارید که ریپینت دارد، نتیجهٔ زمان واقعی میتواند با گزارش آن فاصلهٔ زیادی داشته باشد و ممکن است بخشی از سرمایه یا همهٔ آن را از دست بدهید. پیش از اعتماد به هر بکتست، رفتار اسکریپت را روی کندلهای زنده هم بسنجید.
کدام اشتباهها معاملهگر تازهکار را در پاین اسکریپت گمراه میکند؟
خطاهای این بخش خطای نحوی نیستند. کد بیخطا کامپایل میشود و نمودار هم چیزی نشان میدهد، ولی آنچه نشان میدهد با بازار واقعی نمیخواند.
- تکیه بر کندل در حال شکلگیری: شرطی که میانهٔ کندل زنده برقرار میشود ممکن است تا بستهشدن کندل از بین برود. شرطی را که تصمیم بر آن بنا میشود روی کندل بستهشده بسنجید.
- استفاده از lookahead_on بدون [1]: این همان نشت آینده در بخش ریپینت است و در اسکریپتهایی رخ میدهد که دادهٔ تایمفریم بالاتر را با request.security() میآورند.
- قضاوت دربارهٔ استراتژی از روی نمودار غیراستاندارد: روی نمودارهایی مثل هایکنآشی، قیمت هر کندل از محاسبه به دست میآید و قیمت واقعی بازار نیست. استراتژی روی این نمودار با همین قیمتهای مصنوعی معامله را شبیهسازی میکند و به گفتهٔ مستندات معمولاً نتیجهٔ غیرواقعی میدهد.
خطای سوم یک لایهٔ پنهان هم دارد. شبیهساز کارگزار (broker emulator) بهطور پیشفرض سفارشهای استراتژی را فقط با دادهٔ موجود نمودار پر میکند. پس اگر خود نمودار قیمت مصنوعی نشان دهد، قیمت پرشدن سفارشها در گزارش هم مصنوعی است.
محدودیتهای پاین اسکریپت چیست؟
همهٔ این سقفها از ابریبودن پاین اسکریپت میآیند: پلتفرم منابع محاسباتی را اداره میکند و برای هر اسکریپت حد میگذارد. جدول زیر سقفهای اعلامشده در صفحهٔ محدودیتهای مستندات را کنار هم میگذارد.
سقفها به نقل از صفحهٔ محدودیتهای مستندات تریدینگویو، برداشت اکتبر ۲۰۲۶
| محور | سقف | معنای عملی |
|---|---|---|
| زمان کامپایل | ۲ دقیقه | تبدیل کد به نسخهٔ اجرایی |
| زمان اجرای اسکریپت | ۲۰ ثانیه برای حساب پایه، ۴۰ ثانیه برای سایر حسابها | کل محاسبه روی همهٔ کندلها |
| رسم | ۶۴ شمارش plot در هر اسکریپت | خروجیهای رسمشده |
| بافر تاریخچه | ۵۰۰۰ کندل برای بیشتر سریها | دورترین ارجاع با عملگر [] |
سقف زمان اجرا کل محاسبه را میسنجد، نه یک کندل را. حلقهای سبک روی تاریخچهٔ کوتاه مشکلی ندارد، ولی همان حلقه روی تاریخچهٔ بلند ممکن است به سقف برسد. بافر تاریخچه هم تعیین میکند با عملگر [] تا چند کندل عقب میتوانید ارجاع دهید.
رقم بافر تاریخچه در مستندات با جزئیات و استثنا آمده است. اگر اسکریپت شما به این حد نزدیک است، متن همان صفحه را مرجع بگیرید، چون پلتفرم میتواند این سقفها را در بهروزرسانیهای بعدی تغییر دهد.
از کجا شروع کنید و نسخه ۶ چه تغییرهایی دارد؟
گام اول ساده است: ویرایشگر پاین را باز کنید، با //@version=6 و یک فراخوانی indicator شروع کنید و مثال MACD را خطبهخط بازسازی کنید. مرجع گام بعد صفحههای مدل اجرا و ریپینت در مستندات است، چون خطاهای رایج از همین مفهومها میآیند.
اگر کد یا آموزشی قدیمیتر میخوانید، بدانید پیشفرضهای نسخهٔ ۶ فرق کرده است:
- درخواستهای پویا (dynamic requests) بهطور پیشفرض فعالاند؛ یعنی فراخوانی request.*() با آرگومان متغیر و درون شرط یا حلقه ممکن است.
- مقدار bool دیگر نمیتواند na (مقدار تهی) باشد و فقط true یا false است.
- شرطهای and و or تنبل (lazy) ارزیابی میشوند: اگر بخش اول نتیجه را معلوم کند، بخش دوم محاسبه نمیشود.
- درصد مارجین پیشفرض استراتژی ۱۰۰ است؛ یعنی شبیهساز برای هر پوزیشن کل ارزش آن را از سرمایهٔ حساب کنار میگذارد.
زبان پس از نسخهٔ ۶ هم بهتدریج تغییر میکند؛ برای نمونه، استراتژیها پارامتر calc_on_every_history_tick را هم به دست آوردند. کد نسخههای قدیمیتر را پیش از استفاده با راهنمای مهاجرت به نسخهٔ ۶ تطبیق دهید.
هرچه اینجا میخوانید آموزشی است — نه سیگنالِ ترید، نه توصیهٔ خرید و فروش، نه وعدهٔ نتیجه. تصمیم آخر با خود شماست.
مرجع و تمرین مرتبط
الگو، ستاپ و واژهٔ مرتبط
پرسشهای پرتکرار
پاین اسکریپت را از کجا شروع کنم؟
آیا برای یادگیری پاین اسکریپت باید برنامهنویس باشم؟
پاین اسکریپت با پایتون فرق دارد؟
واژههای این مقاله
منابع
این مقاله با کمکِ ابزارهای هوش مصنوعی تهیه شده است. سیاست تحریریه
دیدگاه خود را ارسال کن
ارسال دیدگاهمطالب مرتبط
ارسال دیدگاه
دیدگاهها پیش از انتشار بررسی میشوند. به پرسشهای معاملاتی پاسخ نمیدهیم و سیگنال نمیدهیم.
دیدگاهها (۰)
هنوز دیدگاهی ثبت نشده؛ اولین نفر باش.