مستندات API
همین آدرسی که خودِ صفحهی «فرصتها» هر ۲۰ ثانیه صداش میزنه، از قبل عمومی و بدون نیاز به ثبتنام یا کلید API است. اگه میخوای دیتای زنده رو توی اکسل، پایتون، یا اسکریپت خودت بخونی، همین آدرس رو مستقیم صدا بزن.
سیگنالهای فعلی
GET
https://alfaleap.xyz/api/v1/opportunities
بدون نیاز به کلید
همهی سیگنالهای فعلاً زنده رو در سه گروه spot، futures و
radar_neutral برمیگردونه. هر گروه از قبل بر اساس امتیاز مرتب شده و سیگنالهای
بستهشده (برد/باخت/منقضی) یا خیلی قدیمی قبلاً حذف شدن — همون چیزی که خود سایت نشون میده.
نمونهی خروجی (کوتاهشده)
{
"generated_at": "2026-09-29T10:40:00+00:00",
"groups": {
"spot": {
"label": "اسپات",
"count": 450,
"shown": 100,
"items": [
{
"symbol": "BTC-USDT",
"base": "BTC",
"source_bot": "crypto-hunter",
"group": "spot",
"direction": "LONG",
"score": 83.6,
"confidence": 71,
"entry_low": 4.87, "entry_high": 4.9, "entry_mid": 4.88,
"stop": 4.33, "tp1": 5.7, "tp2": 6.24, "tp3": 7.07,
"leverage": null,
"note": "ACTIONABLE_SPOT_LONG",
"updated_at": "2026-09-29T10:15:00+00:00",
"stale_hours": 24,
"risk_pct": null,
"factors": {}
}
],
"excluded": { "resolved": 18, "too_old": 8 }
},
"futures": { "...": "همین ساختار" },
"radar_neutral": { "...": "همین ساختار، بدون entry/stop/tp" }
},
"correlation_risk": { "...": "هشدار همجهتی سیگنالهای فیوچرز" },
"sources_health": { "...": "آخرین زمان موفق هر منبع" }
}
فیلدهای هر سیگنال
| فیلد | توضیح |
|---|---|
symbol / base | نماد کامل و نماد پایه (مثلاً BTC-USDT و BTC) |
source_bot | موتور صادرکننده: btc-strength، cryptofusion، crypto-hunter، btc-strength-hyperflow، radar |
direction | LONG یا SHORT؛ برای رادار خالیه (غیرجهتی) |
score | عدد ۰ تا ۱۰۰؛ نزدیک ۱۰۰ یعنی فشار خرید قویتر |
entry_low / entry_high / entry_mid | محدودهی ورود؛ اگه پلن معامله نداشته باشه (مثلاً BTC Strength) خالیه |
stop / tp1 / tp2 / tp3 | حد ضرر و اهداف قیمتی، اگه منبع ارائه کرده باشه |
updated_at | زمان آخرین بهروزرسانی این سیگنال، ISO 8601 |
note | وضعیت خام منبع، مثلاً ACTIONABLE_SPOT_LONG یا WATCH یا PENDING |
سایر endpoint های عمومی
| آدرس | محتوا |
|---|---|
/api/v1/consensus | اجماع و اختلافنظر موتورها روی هر نماد |
/api/v1/performance | نرخ برد و دقت هر موتور (همون دادهی تب Win Rate) |
/api/v1/monthly-report | بایگانی عملکرد ماهانه |
/api/v1/health | وضعیت سلامت سرویس |
این یه API عمومی و بدون احراز هویته، نه یه سرویس تجاری با تضمین SLA. پاسخها هر ۲۰ ثانیه
بهروز میشن (کش سمت سرور)، پس درخواست بیشتر از این فاصله فایدهای نداره. اگه برنامهی خودکاری
مینویسی، فاصلهی حداقل ۲۰ ثانیه بین درخواستها رو رعایت کن.
این صفحه فقط مستنده؛ ساختار پاسخ میتونه در آینده گسترش پیدا کنه (فیلد جدید اضافه بشه)، ولی فیلدهای فعلی حذف یا معنیشون عوض نمیشه بدون اطلاعرسانی.