توثيق Genesis API

كل ما تحتاجه للتكامل: المصادقة والحدود ونقاط النهاية ومخططات الاستجابة.

التوثيقΔ دفتر الأوامر

Δ دفتر الأوامر

TrialStartProMax

«Δ دفتر الأوامر» لكل صف من عملة واحدة في مجموعة بيانات المراجحة المختارة — بالصيغ نفسها المستخدمة في عمود الموقع. أزواج CEX: الشراء عبر طلبات البيع (asks) في المنصة الأولى، والبيع في طلبات الشراء (bids) في الثانية، بحد أقصى هو فرق الصف. صفوف DEX: إشارة الفرق تحدد الاتجاه (≥ 0 — البيع في bids المنصة CEX، < 0 — الشراء من asks)، وإذا انعكست الإشارة تكون النتيجة 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"

مثال استجابة

مثال على الاستجابة — عنصر بيانات واحد، مع اختصار القيم الطويلة:

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 — لم يمتلئ الدفتر