خانه · قیمت‌ها

مستندات API توسعه‌دهنده

API فقط‌خواندنی برای Pro و VIP (مسیر /ext/*) به‌علاوه خروجی Lab برای ادمین و استراتژیست. کلید را از پنل، بخش API بسازید.

احراز هویت

احراز هویت
# Machine key (Pro/VIP / lab scopes)
X-API-Key: mtb_live_…

# Or browser session cookie after login (mtb_session)

کلید فقط یک‌بار نشان داده می‌شود. حداکثر ۳ کلید فعال. حدود ۶۰ درخواست در دقیقه. کاربر نشست بدون کلید هم با نقش به Lab می‌رسد.

محدوده‌ها

  • read:signals — پیش‌فرض کلیدهای تازه؛ مسیرهای /ext/*
  • read:lab — فراداده اجرا، تنظیمات، پوشش، بخش‌ها، جاب‌ها
  • read:trades — دانلود CSV دفتر معاملات
  • read:backtest — به‌عنوان نام مستعار خواندن Lab پذیرفته می‌شود

آدرس پایه

آدرس پایه
https://mytraderbot.online/api/v1

اندپوینت‌های مشترک (/ext)

  • GET /ext/me — خلاصه حساب و پلن
  • GET /ext/signals — لیست سیگنال (only_open, symbol, limit, updated_since)
  • فیلدهای قرارداد: id، strategy_id، created_at، updated_at؛ side/status انگلیسی (open|partial|closed|cancelled)؛ close_reason/close_price؛ tp_hits/remaining_size/realized_r. کانال در زمان انتشار فعال (برچسب paper مجاز است).
  • GET /ext/signals/{id} — جزئیات یک سیگنال
  • GET /ext/journal — ردیف‌های ژورنال
  • GET /ext/journal/stats — خلاصه ژورنال
  • GET /ext/performance — عملکرد شبیه‌سازی و زنده

باندل داده و اسنپ‌شات

کش نسخه‌دار OHLCV، اسنپ‌شات سیستم و باندل دانلود لب برای اجرای آفلاین mtb-engine.

  • GET /engine/data/bundle — زیپ کش OHLCV (مانیفست + sha256)؛ پارامتر from/to/tfs/pairs
  • GET /engine/snapshot — زیپ استراتژی‌های فعال و آرتیفکت‌های اخیر لب
  • GET /lab/runs/{id}/download-bundle.zip — باندل parity هر اجرا (OHLCV + params + trades)
  • GET /engine/meta / GET /engine/download — متا / دانلود ویل موتور

این مسیرها به نشست استراتژیست/ادمین یا کلید API با محدوده lab نیاز دارند. احراز هویت روی اندپوینت‌های سایت اختیاری نیست.

خروجی Lab (فقط‌خواندنی)

هر بک‌تست یک شناسه اجرای جدید و تغییرناپذیر می‌سازد. نشست ادمین یا استراتژیست کافی است؛ کلید ماشین به محدوده نیاز دارد.

  • GET /lab/contract — read:lab — اقتصاد، ریسک، معنای RSI
  • GET /lab/runs — read:lab — فهرست اجراها (limit, cursor, strategy_id)
  • GET /lab/runs/{run_id} — read:lab — فرا: موتور، بازه‌ها، هش‌ها، پوشش
  • GET /lab/runs/{run_id}/config — read:lab — تنظیمات تغییرناپذیر و هش تنظیمات
  • GET /lab/runs/{run_id}/coverage — read:lab — کندل، گپ و تکرار به‌ازای هر نماد
  • GET /lab/runs/{run_id}/trades.csv — read:trades — دفتر کامل معاملات
  • GET /lab/splits — read:lab — آموزش، بررسی، رزرو نهایی و فاصله
  • POST /lab/group-simulate — شبیه‌سازی گروهی با سرمایه مشترک (نه جمع ساده سود و زیان)
  • GET|POST /lab/jobs — صف جاب Lab
  • POST /lab/research/start — تحقیق ثبت‌شده: گرید قفل، رتبه آموزش، گیت بررسی (نهایی مهر شده)
  • GET /lab/research/{id} — پوشش، هش‌ها، گیت بررسی، سبد
  • GET /lab/research/{id}/ledger.csv — read:trades
  • POST /lab/research/{id}/unseal-final — باز کردن یک‌باره پنجره نهایی با confirm_unseal

اقتصاد موتور (قابل بازسازی)

  • سرمایه اولیه پیش‌فرض ۱۰٬۰۰۰ برای هر نماد است (مستقل؛ در بک‌تست تکی سبد مشترک نیست).
  • کارمزد گیرنده و سازنده به‌علاوه لغزش. فاندینگ هر ۸ ساعت سپری‌شده روی پوزیشن باز یک‌بار حساب می‌شود، نه هر کندل.
  • ورود: سیگنال روی کلوز کندل i در اوپن کندل i+1 پر می‌شود. اگر استاپ و تارگت با هم لمس شوند، استاپ مقدم است. max_hold_bars و cooldown_bars پشتیبانی می‌شوند.
  • گیت بررسی: ضریب سود خالص حداقل ۱٫۲ و حداقل ۲۰۰ معامله. نرخ برد ۶۰ تا ۸۰ فقط ترجیح است. خالی بودن کاندیدها نتیجه معتبر است.

مسیر پذیرش تحقیق

  1. POST /lab/research/start — اسنپ‌شات و داده، گرید قفل، رتبه آموزش، گیت بررسی
  2. GET /lab/research/{id} / …/ledger.csv
  3. POST /lab/group-simulate — سبد با سرمایه مشترک
  4. ابتدا پیپر خصوصی، بعد باز کردن یک‌باره پنجره نهایی. شکست نهایی تنظیم‌های هم‌پوشان را آلوده می‌کند.
  5. نمونه آفلاین: python scripts/run_research_acceptance.py

نمونه Lab / تحقیق

curl
curl -sS -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"use_snapshot":true}' \
  "https://mytraderbot.online/api/v1/lab/research/start"

curl -sS -H "X-API-Key: YOUR_KEY" \
  "https://mytraderbot.online/api/v1/lab/research/RESEARCH_ID/ledger.csv" -o ledger.csv

نمونه /ext

curl
curl -sS -H "X-API-Key: YOUR_KEY" \
  "https://mytraderbot.online/api/v1/ext/signals?only_open=true&limit=50"

تأخیر سیگنال و محدودیت پلن مثل وب‌اپ است. این API سفارش ثبت نمی‌کند و کانال فعال را عوض نمی‌کند.

مستندات API · MyTraderBot