فرمولنویسی در دیدهبان اختیار معامله یعنی خودتان تصمیم می‌گیرید جدول چه چیزی نشان بدهد: می‌توانید برای هر قرارداد شرط بگذارید، ستون تازه بسازید، یا یک استراتژی چندپایه را داخل همان جدول بیاورید. فیلترهای آمادهٔ دیدهبان روی فیلدهای از پیش تعریف‌شده کار میکنند؛ فرمول محدودیتی ندارد و هر محاسبه‌ای که بتوانید بنویسید، ستون میشود.
این راهنما دو بخشِ این سیستم را از هم جدا میکند — فرمول برای ستون و فیلتر، و استراتژی آماده برای ترکیب‌های چندپایه — و بعد نشان میدهد هرکدام از کجا باز می‌شوند و چطور ذخیره و به‌اشتراک گذاشته می‌شوند.
این راهنما دربارهٔ خودِ پنجره است، نه دربارهٔ زبان. اینکه فرمول با چه زبانی نوشته میشود و هر دستورش چه میکند، در زبان فرمولنویسی آمده است.
و اگر میخواهید قبل از باز کردن این پنجره روی بازار واقعی، یک بار کل مسیر را تمرین کنید، آموزش تعاملی فرمولنویسی همان ستون و فیلتر را روی دادهٔ نمونه و با دکمهٔ اجرا یاد میدهد.
فهرست مطالب
فرمولنویسی در دیدهبان
در دیدهبان آپشن، یک سیستم فرمولنویسی دارید که با آن می‌توانید برای هر قرارداد شرط بگذارید، ستون اضافه کنید یا استراتژی اختیار معامله به جدول بیاورید. این سیستم دو بخش دارد که هر کدام با یک دکمه در نوار دیدهبان باز می‌شوند:
- — فرمول‌های شخصی خودتان: می‌نویسید، ویرایش میکنید، به دیدهبان وصل میکنید
- — استراتژیهای آماده اختیار معامله (کاوردکال، اسپرد، …) که آپشن‌باز با همین سیستم فرمولنویسی نوشته و برای معامله‌گر آماده کرده
هر دو بخش روی یک موتور کار میکنند. استراتژیهای آماده در واقع فرمول‌هایی هستند که تیم آپشن‌باز از قبل نوشته، تست کرده و با توضیح و نمونه خروجی گذاشته تا معامله‌گر بدون کدنویسی به جدول اضافه کند. بعد از افزودن، استراتژی مثل بقیه فرمول‌های شخصی شما در دیدهبان اجرا میشود.
فیلترهای سرستون و بخش فیلتر آماده در راهنمای دیدهبان توضیح داده شده؛ این مقاله فقط همین سیستم فرمولنویسی را پوشش میدهد.
اشتباه‌های رایج:
- دکمهٔ «افزودن به دیدهبان» یا «افزودن به باکس فعلی» خاکستری است — علت: کد فرمول خطا دارد و برای فرمول خطادار این دکمه (و تیک باکس‌ها در تب «محل استفاده») بسته است — راه‌حل: کنار «کد JavaScript» برچسب «خطای نحوی» یا «خطای اجرا» را ببینید، متن خطا را با نگه داشتن نشانگر روی آن بخوانید و درستش کنید تا «بدون خطا» شود.
- تب «ظاهر» یا «محل استفاده» را نمی‌بینم — علت: تب‌ها به نوع فرمول بستگی دارند؛ «ظاهر» فقط برای ستون است، «محل استفاده» برای تابع نیست، و نوع بعد از ساخت عوض نمیشود — راه‌حل: یک فرمول تازه از نوع درست بسازید و کد را در آن بگذارید.
- دکمهٔ استراتژی «مدیریت یا بروزرسانی» نوشته و افزودن فوری نیست — علت: همین استراتژی را از قبل دارید (تیک سبز کنار نامش در لیست همین را می‌گوید) — راه‌حل: در پنجرهٔ بازشده «استفاده از همین استراتژی» یا، وقتی نسخهٔ تازه هست، «بروزرسانی به نسخهٔ تازه» را بزنید؛ برای تنظیمات و فیلترهای جدا «ساخت کپی مستقل».
دکمه‌های نوار دیدهبان
| دکمه | چه چیزی باز میشود؟ | نکته |
|---|---|---|
| فرمولنویسی | از جدول هم می‌توانید با ویرایش ستون/فیلتر فرمولی وارد شوید | |
| کتابخانه استراتژی | نقطه قرمز/آبی روی دکمه = استراتژی جدید یا آپدیت‌شده در کتابخانه | |
| — | فقط صفحه تکی دیدهبان: استراتژیهای ذخیره‌شده کاربر با نمودار سود و زیان — نه همین کتابخانه استراتژی |
در میزکار روی هر باکس دیدهبان همین دو دکمه هست — فرمول‌ها و اتصالشان به هر باکس جداگانه ذخیره میشود.
📱 در موبایل: این دو دکمه در نوار نیستند؛ «امکانات بیشتر» را بزنید و ردیف «کتابخانه استراتژی‌ها» یا «فرمول نویسی» را باز کنید.
بخش فرمولنویسی
با پنجره‌ای باز میشود که عنوانش فرمولنویسی است. می‌توانید آن را بکشید (از نوار بالا) و اندازه‌اش را عوض کنید (از گوشه). از بالای پنجره:
فهرست کامل چیزی که در تب «آماده» نشسته است — با تنظیمات هرکدام — در فرمول‌های آماده دیدهبان اختیار معامله آمده است.
- — باز/بسته کردن ستون راست (لیست فرمول‌ها)
- دستیار هوش مصنوعی — اگر برای حساب شما فعال باشد، پنل دستیار را داخل همین پنجره باز میکند و کنار کد هم «از دستیار بپرس» هست؛ راهنما: راهنمای دستیار هوش مصنوعی
- راهنما — لینک به راهنمای فرمولنویسی (فیلدها، توابع،
optionوua) - — بستن پنجره و برگشت به دیدهبان
ستون راست — دو تب
| تب | محتوا |
|---|---|
| فرمول‌های من | همه فرمول‌ها، توابع و فیلتر/ستونهای ساخته‌شده توسط شما — دکمه فرمول جدید، فیلتر نوع (همه / تابع / فیلتر / ستون)، مرتب‌سازی، جست‌وجو |
| آماده | کتابخانه فرمول‌های آماده آپشن‌باز — انتخاب کنید، جزئیات ببینید، «اضافه به فرمول‌های من» |
روی هر آیتم در لیست کلیک کنید تا در بخش راست باز شود. آیتم‌های خطادار با آیکون هشدار مشخص می‌شوند — وقتی فرمول خطادار دارید، دکمهٔ «نمایش موارد خطادار (N)» بالای لیست فقط همان‌ها را نشان میدهد.
ویرایشگر — ساخت فرمول جدید
با فرمول جدید یا انتخاب یک آیتم، بخش ویرایشگر فعال میشود. بالای آن نام و نوع است و زیرش سه تب: کد، ظاهر (فقط ستون) و محل استفاده (ستون و فیلتر؛ تابع ندارد):
| بخش | توضیح |
|---|---|
| نام | عنوان در لیست و چیپ فیلتر |
| توضیح کوتاه ستون (تب «ظاهر») | فقط نوع «ستون» — متنی که در راهنمای عنوان ستون نمایش داده میشود |
| نوع (فقط هنگام ساخت) | تابع — قابل فراخوانی در فرمول‌های دیگر · فیلتر — فقط ردیفهایی که return true · ستون — مقدار محاسباتی در هر ردیف |
| کد JavaScript (تب «کد») | ویرایشگر با بررسی زنده — «بدون خطا» سبز، «خطای نحوی/اجرا» قرمز. جزئیات API در راهنمای فرمول |
| تب «ظاهر» | فقط نوع «ستون»: «رنگ متن»، «رنگ پس‌زمینه»، «اندازه فونت» (کوچک/متوسط/بزرگ) و «تراز متن» (راست/وسط/چپ)، و همان‌جا «توضیح کوتاه ستون» |
| تب «محل استفاده» | ستون و فیلتر (تابع ندارد). در میزکار هر باکس یک تیک دارد: برای فرمول ذخیره‌شده تیک زدن همان لحظه آن را به باکس اضافه یا از آن برمی‌دارد، و برای ستون «نمایش» / «مخفی» هم هست؛ فرمول تازه پس از ذخیره به باکس‌های تیک‌خورده وصل میشود (باکس فعلی از اول تیک دارد). در صفحهٔ تکی دیدهبان فقط وضعیت «فعال در دیدهبان» / «غیرفعال در دیدهبان» با دکمهٔ «افزودن به دیدهبان» / «برداشتن از دیدهبان» هست و فرمول تازه پس از ذخیره خودکار اضافه میشود. |
دکمه‌های پایین ویرایشگر
- ذخیره فرمول — فرمول تازه را در کتابخانهٔ شخصی می‌گذارد؛ نام دکمه با جا و نوع عوض میشود: «ذخیره و افزودن به دیدهبان» (صفحهٔ تکی)، «ذخیره و اتصال به N باکس» (میزکار، وقتی باکسی تیک دارد)، «ذخیره تابع» (نوع تابع). برای فرمول ذخیره‌شده: بروزرسانی تغییرات
- حذف فرمول — حذف از کتابخانه (با تأیید)
- بک‌تست این فرمول — فقط برای ستون و فیلتر ذخیره‌شده؛ در یک تب تازه صفحهٔ بک‌تست را باز میکند که همین فرمول را روز به روز روی تاریخچهٔ یک نماد پایه بازپخش میکند (راهنمای بک‌تست)
- افزودن به دیدهبان / برداشتن از دیدهبان — صفحهٔ تکی: ستون یا فیلتر را به جدول فعلی وصل/قطع میکند
- افزودن به باکس فعلی / حذف از باکس فعلی — میزکار: همین کار برای باکسی که پنجره را از آن باز کرده‌اید؛ باکس‌های دیگر از تب «محل استفاده»
فیلترهای ساخته‌شده از فیلتر سرستون در لیست «فرمول‌های من» دیده نمی‌شوند — فقط از چیپ و pill خودشان در نوار فیلتر دیدهبان مدیریت می‌شوند. بقیه فرمول‌ها اینجا ویرایش می‌شوند.
مثال‌های سریع
فیلتر — نقدشونده:
ستون — فاصله تا سر به سر:
برای کاوردکال و بلک‌شولز: فرمول کاوردکال، فرمول بلک‌شولز.
بخش استراتژیهای آماده
با فهرست استراتژیهای آماده اختیار معامله باز میشود — کاوردکال، اسپرد، استرانگل و دیگر استراتژیهای رایج که آپشن‌باز با همین سیستم فرمولنویسی ساخته و با توضیح و نمونه خروجی گذاشته. هر استراتژی معمولاً هم ستون (آیکون نمودار سود و زیان) و هم منطق فیلتر دارد.
میخواهید کد پشت یک استراتژی را ببینید یا ویرایش کنید؟ در جزئیات هر استراتژی تب کد را باز کنید، کپی کنید و در بخش فرمولنویسی () ویرایشش کنید.
بالای پنجره
- — جست‌وجو در نام استراتژی
- شمارنده — تعداد کل یا «فیلترشده/کل»
لیست استراتژی‌ها (سمت راست)
| کنترل | کار |
|---|---|
| مرتب‌سازی | بر اساس بروزرسانی (جدید/قدیم) یا نام (الف→ی) |
| فیلتر جهت بازار | صعودی · نزولی · ساید · نوسانی — هر کدام را toggle کنید تا فقط استراتژیهای همان دسته بمانند |
| لیست استراتژی‌ها | کلیک = انتخاب · دوبار کلیک = افزودن سریع · سبز = قبلاً در این دیدهبان/باکس فعال است |
| برچسب جدید / آپدیت | استراتژی تازه در کتابخانه یا نسخه به‌روز شده از آخرین بازدید شما |
کلیدهای ↑ ↓ در لیست حرکت می‌دهند؛ Enter همان دکمهٔ افزودن پایین جزئیات است — وقتی مکان‌نما داخل کادر جست‌وجو نباشد.
📱 در موبایل: لیست و جزئیات دو صفحهٔ جدا هستند؛ روی یک استراتژی بزنید تا جزئیاتش باز شود و با «بازگشت به لیست» برگردید.
جزئیات استراتژی (سمت چپ)
وقتی یک استراتژی انتخاب میکنید:
- عنوان + برچسب جهت (صعودی/…) + تاریخ بروزرسانی
- لینک راهنما — اگر در کد لینک مقاله دانشنامه باشد (مثلاً کاوردکال)
- سه تب:
- معرفی — شرح استراتژی و نحوهٔ استفاده
- نمونه خروجی — پیش‌نمایش سلول جدول، سناریوهای نمونه، راهنمای آیکون نمودار
- کد — کد JavaScript + دکمهٔ کپی
- اگر استراتژی تنظیمات بصری دارد (پارامتر strike، درصد، …): بعد از افزودن با روی برچسب فیلتر یا ستون تنظیم کنید — پنجرهٔ تنظیمات باز میشود
- اگر استراتژی نمودار سود و زیان دارد: در سلول جدول آیکون نمودار می‌بینید — با کلیک به نمودار استراتژی می‌روید
دکمهٔ افزودن (پایین جزئیات)
نام این دکمه به جا و وضعیت بستگی دارد: افزودن به دیدهبان (صفحهٔ تکی)، افزودن و اتصال به این باکس (میزکار)، و مدیریت یا بروزرسانی وقتی این استراتژی را از قبل دارید (تیک سبز کنار نامش در لیست). کار دکمه:
- استراتژی را به فرمول‌های من اضافه میکند
- در صفحه تکی: ستون را به دیدهبان فعلی فعال میکند
- در میزکار: به باکس جاری وصل میکند (ممکن است از شما بپرسد کدام باکس را میخواهید)
- اگر قبلاً اضافه شده: پنجرهٔ «این استراتژی را از قبل دارید» باز میشود؛ «استفاده از همین استراتژی» همان را فعال یا وصل میکند
- اگر نسخهٔ کتابخانه عوض شده: پنجرهٔ «نسخهٔ تازه‌ای از این استراتژی موجود است» با بروزرسانی به نسخهٔ تازه؛ تنظیمات و فیلترهای شخصی شما حفظ میشود
- در هر دو پنجره «یا یک کپی مستقل بسازید» ← «ساخت کپی مستقل» نسخه‌ای جدا با تنظیمات و فیلترهای خودش می‌سازد؛ «انصراف» بی‌تغییر برمی‌گردد
بعد از افزودن، یک دکمهٔ تیک‌دار به نام استراتژی در ردیف فیلترهای دیدهبان ظاهر میشود — با کلیک روی آن فعال/غیرفعال میشود؛ با پارامترها را عوض کنید. جزئیات در نمای فیلتر دیدهبان.
بعد از افزودن — در جدول چه می‌بینید؟
فرمول‌هایی که می‌سازید روی حساب شما همگام می‌شوند و هر شب هم از آن‌ها نسخهٔ پشتیبان گرفته میشود — راهنمای بک‌آپ و بازیابی اطلاعات.
| نوع فرمول | در جدول | در بخش فیلتر |
|---|---|---|
| ستون (مثلاً فاصله تا سر به سر) | یک ستون جدید در جدول با عدد یا متن محاسبه‌شده برای هر قرارداد — از قابل نمایش/مخفی | — |
| شرط (مثلاً فقط قراردادهای نقدشونده) | قراردادهایی که شرط را ندارند از جدول حذف می‌شوند | دکمهٔ تیک‌دار در ردیف فیلترها — روشن/خاموش و |
| استراتژی آماده (مثلاً کاوردکال) | ستون با آیکون نمودار سود و زیان — کلیک روی آیکون نمودار کامل را نشان میدهد | برچسب استراتژی + برای تنظیم پارامترها |
برای ساخت دستی نمودار سود و زیان از چند قرارداد، از نمودار استراتژی یا (صفحه تکی) استفاده کنید — جدا از کتابخانه استراتژی که در این مقاله توضیح داده شد.
جمع‌بندی
هر دو بخش روی یک سیستم کار میکنند. با خودتان شرط یا ستون می‌نویسید؛ با استراتژیهای آماده اختیار معامله را انتخاب و به جدول اضافه میکنید — بدون نوشتن کد. بعد از افزودن، همه با هم در دیدهبان اجرا می‌شوند.
برای شرط ساده از فیلتر سرستون شروع کنید؛ شرط پیچیده یا ستون اختصاصی → ؛ استراتژی آماده (کاوردکال، اسپرد، …) → .
کدام قدم کار با «فرمول نویسی» برایتان گنگ بود؟ همین پایین بپرسید.