مستندات 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
directionLONG یا 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. پاسخ‌ها هر ۲۰ ثانیه به‌روز میشن (کش سمت سرور)، پس درخواست بیشتر از این فاصله فایده‌ای نداره. اگه برنامه‌ی خودکاری می‌نویسی، فاصله‌ی حداقل ۲۰ ثانیه بین درخواست‌ها رو رعایت کن.

این صفحه فقط مستنده؛ ساختار پاسخ می‌تونه در آینده گسترش پیدا کنه (فیلد جدید اضافه بشه)، ولی فیلدهای فعلی حذف یا معنی‌شون عوض نمیشه بدون اطلاع‌رسانی.