مستندات Genesis API
هرچه برای یکپارچهسازی لازم است: احراز هویت، محدودیتها، اندپوینتها و اسکیمای پاسخ.
مستنداتΔ دفتر سفارش
Δ دفتر سفارش
TrialStartProMax
«Δ دفتر سفارش» برای هر ردیف یک کوین در مجموعه داده آربیتراژ انتخابشده — با همان فرمولهای ستون سایت. جفتهای CEX: خرید از askهای صرافی اول، فروش به bidهای دومی، با سقف اسپرد ردیف. ردیفهای DEX: علامت اسپرد جهت را تعیین میکند (≥ 0 — فروش به bidهای CEX، < 0 — خرید از askها)، علامت معکوس 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"
نمونه پاسخ
نمونه پاسخ — یک عنصر 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.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 — دفتر پر نشد |