فرمول‌نویسی با هوش مصنوعی | پرامپت اختصاصی و مرجع کامل توابع

من می‌خواهم یک فرمول/فیلتر برای دیده‌بان اختیار معامله (آپشن) در پلتفرم آپشن‌باز بنویسم. کد نهایی باید به زبان جاوااسکریپت (ES6) باشد و مقدار خروجی را با تگ return برگرداند. لطفاً بر اساس مرجع کامل فیلدها، توابع و ساختار فرمول‌نویسی که در زیر آورده‌ام، فرمول مدنظر من را بنویس: --- مرجع فیلدها و توابع پلتفرم --- 1. آبجکت‌های اصلی: - option: اطلاعات قرارداد جاری (مانند استرایک، روز تا سررسید و ...) - ua: اطلاعات دارایی پایه قرارداد جاری (مانند نوسان تاریخی HV، رتبه و ...) 2. فیلدهای آبجکت option: - option.namad: نماد اختیار (رشته - مانند ضهرم8004) - option.name: نام کامل نماد اختیار (رشته) - option.strike: قیمت اعمال (عدد) - option.type: نوع قرارداد ("call" یا "put") - option.daysUntilMaturity: تعداد روزهای تقویمی تا سررسید (عدد) - option.dayTradesUntilMaturity: تعداد روزهای معاملاتی تا سررسید (عدد) - option.size: اندازه قرارداد (تعداد سهم، معمولاً 1000) - option.state: وضعیت قرارداد ("ITM" | "ATM" | "OTM") - option.openInterest: موقعیت‌های باز (عدد) - option.openInterestPC: درصد تغییر موقعیت باز نسبت به روز قبل - option.iv: نوسان‌پذیری ضمنی (عدد بین 0 تا 1) - option.requiredMargin: وجه تضمین کلید (عدد) - option.minimumMargin: حداقل مارجین قابل قبول - option.blackSholesHV: قیمت نظری بلک‌شولز از پیش‌محاسبه‌شده با HV پایه (ua.hv) - option.fee: کارمزد خرید و فروش قرارداد اختیار (به صورت ضریب، مثلاً 0.001) - option.buyExerciseFee: کارمزد اعمال خرید (ضریب) - option.writeExerciseFee: کارمزد اعمال فروش (ضریب) 3. فیلدهای آبجکت ua (دارایی پایه): - ua.namad: نماد سهم پایه (رشته - مانند خودرو، اهرم) - ua.name: نام کامل سهم پایه - ua.hv: نوسان‌پذیری تاریخی سهم پایه (عدد بین 0 تا 1) - ua.ivRank: رتبه نوسان‌پذیری ضمنی نسبت به یک سال گذشته (0 تا 100) - ua.ivPercentile: درصد نوسان‌پذیری ضمنی (0 تا 100) - ua.isEtf: آیا سهم پایه صندوق است؟ (boolean) - ua.buyFee: کارمزد خرید سهم پایه - ua.sellFee: کارمزد فروش سهم پایه 4. فیلدهای اطلاعات معاملاتی روز (ti) - قابل دسترسی روی option.ti و ua.ti: - lastPrice: آخرین قیمت معامله‌شده - lastPC: درصد تغییر آخرین قیمت نسبت به دیروز - endPrice: قیمت پایانی - endPC: درصد تغییر قیمت پایانی - volume: حجم معاملات امروز - tValue: ارزش معاملات امروز (ریال) - lastDayVolume: حجم معاملات روز قبل - lastDayTValue: ارزش معاملات روز قبل - min: کمترین قیمت معامله‌شده امروز - max: بیشترین قیمت معامله‌شده امروز - dailyPriceLow: حد پایین دامنه نوسان قیمت روز (فقط روی ua.ti دامنه واقعی است) - dailyPriceHigh: حد بالای دامنه نوسان قیمت روز (فقط روی ua.ti دامنه واقعی است؛ روی option.ti حد مطلق ابزار در آن می‌نشیند نه دامنه نوسان) - صف خرید/فروش 5 سطحی: buy1Price تا buy5Price و sell1Price تا sell5Price (قیمت‌ها) و حجم‌های متناظر: buy1Volume تا buy5Volume و sell1Volume تا sell5Volume - آمار حقیقی/حقوقی: realBuyVolume, coBuyVolume, realSellVolume, coSellVolume و تعداد خریدار/فروشنده: realBuyCount, coBuyCount, realSellCount, coSellCount 5. توابع کمکی تحلیلی و معاملاتی: - intrinsic(): ارزش ذاتی قرارداد (تفاوت قیمت پایه و استرایک بر اساس نوع خرید/فروش) - timeValue(): ارزش زمانی قرارداد (حق‌پریمیوم منهای ارزش ذاتی مثبت) - isITM(): آیا قرارداد در سود (In-the-Money) است؟ (boolean) - breakeven(): قیمت نقطه سر به سر قرارداد در سررسید - leverage(): اهرم ساده قرارداد، بدون دلتا (قیمت پایه تقسیم بر قیمت اختیار) - effectiveLeverage(): اهرم مؤثر قرارداد — leverage() ضربدر قدر مطلق دلتا؛ همان عددی که ستون «اهرم» در دیده‌بان نشان می‌دهد - askBidSpread(): درصد فاصله بهترین قیمت خرید و فروش (اسپرد) از آخرین قیمت - probOfProfit(bePrice, currentPrice, iv, daysToMaturity): درصد احتمال موفقیت/سود تا سررسید (بین 0 تا 100) - uaDailyRange(): دامنه نوسان امروز نماد پایه به صورت آبجکت { base, low, high, upPct, downPct } — base قیمت پایانی دیروز، low و high کف و سقف مجاز (جای صف فروش و صف خرید) و upPct و downPct همان‌ها به درصد. فقط برای نماد پایه بورس و فرابورس مقدار دارد و در بقیه حالت‌ها null است، پس اول باید بررسی شود - uaPriceRange(days?): قیمتی که نماد پایه با چند روز صف خرید (high) یا صف فروش (low) پشت سر هم می‌تواند به آن برسد — دامنه روزانه به صورت مرکب روی days روز معاملاتی. بدون آرگومان option.dayTradesUntilMaturity همان قرارداد را می‌گیرد. خروجی { base, days, low, high, upPct, downPct } و در نبود دامنه معتبر null - basePrice(item): قیمت بر اساس مبنای انتخابی کاربر در دیده‌بان (پاس دادن option یا ua به عنوان ورودی) 6. توابع محاسباتی و بازدهی: - ytmProfit(r, t): بازدهی تا سررسید سالانه‌شده (r درصد بازدهی کل، t روز تا سررسید) - monthlyProfit(profit, days): بازدهی ماهانه بر اساس درصد سود و تعداد روز 7. توابع فرمت‌دهی و زیباسازی خروجی سلول‌ها (رنگ و متن): - roundNumber(number, maxDecimals?): گرد کردن عدد تا تعداد اعشار مشخص - commaSeparator(val, fixed?): جدا کردن سه رقم سه رقم عدد - formatNumber(x, fixed?): فرمت‌دهی عدد بزرگ همراه با حروف K، M و B - calcRateChange(n1, n2, fix?): درصد تغییر از عدد n1 به n2 - rnwc(x, fixed?, fixedB?, isCurrency?, wordifyTitleSpan?, showZero?): نمایش پیشرفته عدد همراه با رنگ، فرمت و تبدیل به حروف فارسی در تولتیپ - rnWordify(val, fromTable?): تبدیل عدد به حروف فارسی همراه با واحدهای ریال/درصد - wordifyfa(num): تبدیل ساده عدد به حروف فارسی - namadNo(namad): استخراج عدد انتهای نماد (مثلاً 8004 از ضهرم8004) برای یافتن استرایک یا تاریخ - style(value, color, bg?, title?, bold?): استایل‌دهی سلول با رنگ متن، پس‌زمینه، تولتیپ و ضخامت متن - colorCondition(value, min, minColor, max, maxColor, mode?, comma?): رنگ‌آمیزی شرطی عدد بین دو بازه - colorRange(val, ranges): رنگ‌آمیزی بر اساس بازه‌های دلخواه (آرایه‌ای از قوانین رنگ) - showDetail(optionName, title?): ساخت دکمه باز کردن جزئیات قرارداد در پایین صفحه - copyToClipboard(value): ساخت دکمهٔ کپی کردن یک مقدار در حافظه کلاینت - createPriceLine({ width, points, currentPrice, marginPercent? }): ساخت نمودار خطی کوچک مینیاتوری از قیمت نسبت به نقاط استرایک - sortAndFormatResults(items, sortBy, sortDir?, displayInline?): مرتب‌سازی گزینه‌های یک استراتژی در یک سلول و قالب‌بندی خروجی با خط افقی یا لوله 8. توابع ساخت سبد استراتژی و شبیه‌ساز (P/L): - pos.add(position, namad, count?, price?, cashBlock?): اضافه کردن یک موقعیت به سبد شبیه‌ساز. پارامتر position می‌تواند یکی از مقادیر 'buy_call' | 'sell_call' | 'buy_put' | 'sell_put' | 'buy_stock' | 'sell_stock' باشد. - pos.build(name?, tradingFee?, exerciseFee?): نهایی‌سازی و تولید دکمهٔ نمایش نمودار سود/زیان (P/L) و ساخت استراتژی تعاملی در صفحه - pos.clear(): پاکسازی سبد شبیه‌ساز قبل از محاسبات جدید 9. توابع محاسبات بلک‌شولز و یونانی‌ها: - calcBS(namad?) | calcBS(overrides?): محاسبه بلک‌شولز و استخراج یونانی‌ها. خروجی یک آبجکت است شامل: { bs: قیمت تئوری, delta: دلتا, gamma: گاما, theta: تتا, vega: وگا, rho: رو } ورودی overrides می‌تواند اختیاری شامل { uaPrice, strike, iv, days, rate, type } باشد. 10. توابع جستجو و زنجیره قراردادها: - getOptionsByChain(uaNamad, type?, days?): دریافت کل قراردادهای زنجیرهٔ یک دارایی پایه - getOptionByParam(type?, strike?, days?, baseNamad?): جستجوی دقیق یک قرارداد بر اساس مشخصات - optionSE(strikeNo?, type?): دریافت قرارداد هم‌سررسید با چند استرایک بالاتر یا پایین‌تر (مثلاً 1 برای یک استرایک بالاتر، 1- برای پایین‌تر) - optionSU(namad?, type?): دریافت قرارداد با سررسید متفاوت اما استرایک دقیقاً یکسان - getOptionByNamad(namad): دریافت مستقیم آبجکت قرارداد دیگر با استفاده از نماد فارسی آن - getUaByNamad(namad): دریافت مستقیم آبجکت دارایی پایه دیگر با استفاده از نماد فارسی آن --- قوانین کلیدی فرمول‌نویسی و کنترل‌های ویژوال --- 1. ساختار متغیرهای تعاملی (ویژوال): هر ثابتی که با حروف بزرگ و یکی از پیشوندهای معتبر تعریف شود، در پنجره تنظیمات به عنوان کنترل تعاملی ظاهر می‌شود. نوع کنترل از روی مقدار اولیه و کامنت انتهای همان خط ساخته می‌شود. قوانین نگارش کامنت برای ساخت دکمه‌ها: - عدد (Number): مقدار اولیه عددی. const FILTER_MIN_VOL = 100; // حداقل حجم - تیک روشن/خاموش (Checkbox): مقدار اولیه منطقی true/false. const SETTING_FEE = true; // محاسبه کارمزد - لیست کشویی تک‌انتخابی (Select Dropdown): گزینه‌ها با براکت [مقدار=برچسب] یا [مقدار] مشخص می‌شوند. برای ساخت گزینه خالی یا خط تیره از [] استفاده می‌شود. const FILTER_STATE = 'ITM'; // وضعیت [ITM=در سود] [OTM=در زیان] [ATM=بی‌تفاوت] [] - لیست چندانتخابی (Multi-Select): کلمه کلیدی multi در کامنت قرار می‌گیرد و گزینه‌ها با براکت مشخص می‌شوند. مقدار ذخیره شده در متغیر رشته‌ای جدا شده با ویرگول (مثلا '1,3') خواهد بود. const FILTER_ZONES = '1,2'; // محدوده قیمتی multi [1=پایین] [2=وسط] [3=بالا] - توضیح راهنما (Tooltip): با قرار دادن title=توضیحات در کامنت ظاهر می‌شود. const FILTER_DISTANCE = ''; // فاصله تا اعمال title=عدد مثبت به معنای بالای استرایک است 2. مرتب‌سازی ویژوال (SORT_BY & SORT_DIR): برای افزودن مرتب‌سازی به پنجره تعاملی، از این دو ثابت با گزینه‌های دلخواه استفاده کن: const SORT_BY = 'profit'; // [profit=سود] [volume=حجم] const SORT_DIR = 'desc'; // [asc=صعودی] [desc=نزولی] 3. ترتیب نمایش و چیدمان کشیدنی (Display Order): اگر فرمول بخش‌های نمایشی مختلفی دارد، متغیرهای SHOW_ را همراه با آرایه displayOrder تعریف کن تا کاربر بتواند با کشیدن و رها کردن ترتیب آن‌ها را تغییر دهد: const SHOW_VOLUME = true; // نمایش حجم const SHOW_IV = true; // نمایش IV const displayOrder = ['SHOW_VOLUME', 'SHOW_IV']; 4. الگوی استاندارد فیلتر دوکاره (ستون + فیلتر ردیف): کدهای شما باید دوکاره باشند؛ یعنی هم بتوانند به عنوان ستون در جدول مقدار نشان دهند و هم به عنوان فیلتر کل ردیف کار کنند. ساختار اجباری فیلتر دوکاره به شکل زیر است: const FILTER_RESULT = false; // سوئیچ فعال‌سازی فیلتر کل جدول const FILTER_SHOW = true; // فیلتر در نمایش سلول‌های ستون let isMatched = [شرط فیلتر شما، مثلاً حجم بزرگتر از فیلتر]; if (FILTER_RESULT) return isMatched; // اگر به عنوان فیلتر ردیف فعال شد، مقدار بولی برگردان if (!FILTER_SHOW && !isMatched) return ''; // اگر سلول شرط را نداشت و فیلتر نمایش فعال نبود، خالی بماند // در غیر این صورت خروجی سلول را چاپ کن: return [خروجی نهایی شما، مثلاً مقدار حجم یا دکمه استراتژی]; حالا درخواست من این است: [درخواست فرمول نویسی خود را در این بخش بنویسید]