مستندات Genesis API

هرچه برای یکپارچه‌سازی لازم است: احراز هویت، محدودیت‌ها، اندپوینت‌ها و اسکیمای پاسخ.

مستنداتΔ دفتر سفارش

Δ دفتر سفارش

TrialStartProMax

«Δ دفتر سفارش» برای هر ردیف یک کوین در مجموعه داده آربیتراژ انتخاب‌شده — با همان فرمول‌های ستون سایت. جفت‌های CEX: خرید از askهای صرافی اول، فروش به bidهای دومی، با سقف اسپرد ردیف. ردیف‌های DEX: علامت اسپرد جهت را تعیین می‌کند (≥ 0 — فروش به bidهای CEX، < 0 — خرید از askها)، علامت معکوس 0 می‌دهد. volume = 0 — با بهترین قیمت‌های دفتر.

GEThttps://api.genesisarbitrage.com/v1/orderbooks/spreads/{dataset}?coin={coin}&volume=5000
امتحان درخواست
GET/v1/orderbooks/spreads/spot-futures?coin=BTC&volume=5000

کلید فقط در مرورگر شما ذخیره می‌شود و جز به API جایی فرستاده نمی‌شود.

کلید را بچسبانید و درخواست بزنید — پاسخ خلاصه‌شده را نشان می‌دهیم.

پارامترهای درخواست

پارامترنوعتوضیح
{dataset}stringمجموعه داده در مسیر: spot-spot، spot-futures، futures-futures، dex-spot یا dex-futures
coinstringنماد کوین (الزامی)
volumenumber0 (پیش‌فرض) — بهترین قیمت‌های دفتر، یا 500، 1000، 2500، 5000، 10000

نمونه درخواست

bash
curl "https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-futures?coin=BTC&volume=5000" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

نمونه پاسخ

نمونه پاسخ — یک عنصر data، مقادیر بلند کوتاه شده‌اند:

json
{
  "coin": "BTC",
  "exchange_buy": "Binance",
  "exchange_sell": "ByBit",
  "market_buy": "spot",
  "market_sell": "futures",
  "price_buy": 96016,
  "price_sell": 96046,
  "ask_buy": 96016,
  "bid_sell": 96045.8,
  "spread_pct": 0.031,
  "order_delta": {
    "volume": 5000,
    "buy_price": 96019.8,
    "sell_price": 96039.2,
    "spread_pct": 0.0202,
    "status": "ok"
  }
}

فیلدهای پاسخ

فیلدنوعتوضیح
…همه فیلدهای ردیف مجموعه داده — مانند اندپوینت آن
order_delta.volumenumberحجم محاسبه، USD (0 — بهترین قیمت‌ها)
order_delta.buy_price / sell_pricenumber | nullجفت CEX: قیمت خرید و فروش برای این حجم
order_delta.side / cex_pricestring / number | nullردیف DEX: سمت CEX (sell یا buy) و قیمت اجرا
order_delta.spread_pctnumber | nullاسپرد پس از اجرا از طریق دفترها، %
order_delta.statusstringok؛ no_book — دفتری نیست؛ exhausted — دفتر پر نشد