مستندات 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/pairsGET /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— اقتصاد، ریسک، معنای RSIGET /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— صف جاب LabPOST /lab/research/start— تحقیق ثبتشده: گرید قفل، رتبه آموزش، گیت بررسی (نهایی مهر شده)GET /lab/research/{id}— پوشش، هشها، گیت بررسی، سبدGET /lab/research/{id}/ledger.csv—read:tradesPOST /lab/research/{id}/unseal-final— باز کردن یکباره پنجره نهایی با confirm_unseal
اقتصاد موتور (قابل بازسازی)
- سرمایه اولیه پیشفرض ۱۰٬۰۰۰ برای هر نماد است (مستقل؛ در بکتست تکی سبد مشترک نیست).
- کارمزد گیرنده و سازنده بهعلاوه لغزش. فاندینگ هر ۸ ساعت سپریشده روی پوزیشن باز یکبار حساب میشود، نه هر کندل.
- ورود: سیگنال روی کلوز کندل i در اوپن کندل i+1 پر میشود. اگر استاپ و تارگت با هم لمس شوند، استاپ مقدم است. max_hold_bars و cooldown_bars پشتیبانی میشوند.
- گیت بررسی: ضریب سود خالص حداقل ۱٫۲ و حداقل ۲۰۰ معامله. نرخ برد ۶۰ تا ۸۰ فقط ترجیح است. خالی بودن کاندیدها نتیجه معتبر است.
مسیر پذیرش تحقیق
POST /lab/research/start— اسنپشات و داده، گرید قفل، رتبه آموزش، گیت بررسیGET /lab/research/{id}/…/ledger.csvPOST /lab/group-simulate— سبد با سرمایه مشترک- ابتدا پیپر خصوصی، بعد باز کردن یکباره پنجره نهایی. شکست نهایی تنظیمهای همپوشان را آلوده میکند.
- نمونه آفلاین: python scripts/run_research_acceptance.py
نمونه Lab / تحقیق
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 -sS -H "X-API-Key: YOUR_KEY" \
"https://mytraderbot.online/api/v1/ext/signals?only_open=true&limit=50"تأخیر سیگنال و محدودیت پلن مثل وباپ است. این API سفارش ثبت نمیکند و کانال فعال را عوض نمیکند.