توثيق Genesis API
كل ما تحتاجه للتكامل: المصادقة والحدود ونقاط النهاية ومخططات الاستجابة.
التوثيقΔ دفتر الأوامر
Δ دفتر الأوامر
TrialStartProMax
«Δ دفتر الأوامر» لكل صف من عملة واحدة في مجموعة بيانات المراجحة المختارة — بالصيغ نفسها المستخدمة في عمود الموقع. أزواج CEX: الشراء عبر طلبات البيع (asks) في المنصة الأولى، والبيع في طلبات الشراء (bids) في الثانية، بحد أقصى هو فرق الصف. صفوف DEX: إشارة الفرق تحدد الاتجاه (≥ 0 — البيع في bids المنصة CEX، < 0 — الشراء من asks)، وإذا انعكست الإشارة تكون النتيجة 0. volume = 0 — عند أفضل أسعار الدفتر.
GET
https://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 |
coin | string | رمز العملة (إلزامي) |
volume | number | 0 (الافتراضي) — أفضل أسعار الدفتر، أو 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.volume | number | حجم الحساب، USD (0 — أفضل الأسعار) |
order_delta.buy_price / sell_price | number | null | زوج CEX: سعر الشراء والبيع لهذا الحجم |
order_delta.side / cex_price | string / number | null | صف DEX: جانب CEX (sell أو buy) وسعر التنفيذ |
order_delta.spread_pct | number | null | الفرق بعد التنفيذ عبر الدفاتر، % |
order_delta.status | string | ok؛ no_book — لا دفتر؛ exhausted — لم يمتلئ الدفتر |