مستندات Genesis API
هرچه برای یکپارچهسازی لازم است: احراز هویت، محدودیتها، اندپوینتها و اسکیمای پاسخ.
مستنداتدفتر سفارش بازار
دفتر سفارش بازار
TrialStartProMax
دفتر سفارش یک بازار، مانند پنجره «دفتر سفارش» سایت: بهترین قیمتها، 10 سطح در هر سمت به $، بزرگترین دیوارها، عمق در ±50% و سن دفتر. depth_limited — صرافی عمق محدودی منتشر میکند، پس حجمهای بزرگ ممکن است پر نشوند.
GET
https://api.genesisarbitrage.com/v1/orderbooks/book?exchange=Binance&market=spot&coin={coin}امتحان درخواست
GET
/v1/orderbooks/book?exchange=Binance&market=spot&coin=BTCکلید فقط در مرورگر شما ذخیره میشود و جز به API جایی فرستاده نمیشود.
کلید را بچسبانید و درخواست بزنید — پاسخ خلاصهشده را نشان میدهیم.
پارامترهای درخواست
| پارامتر | نوع | توضیح |
|---|---|---|
exchange | string | صرافی (بدون حساسیت به حروف بزرگ و کوچک) |
market | string | spot یا futures |
coin | string | نماد کوین (الزامی) |
نمونه درخواست
bash
curl "https://api.genesisarbitrage.com/v1/orderbooks/book?exchange=Binance&market=spot&coin=BTC" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
نمونه پاسخ
نمونه پاسخ — یک عنصر data، مقادیر بلند کوتاه شدهاند:
json
{
"exchange": "Binance",
"market": "spot",
"coin": "BTC",
"book_ts": 1794675858,
"age_sec": 6,
"stale": false,
"source": "ws",
"depth_limited": false,
"levels_bid": 500,
"levels_ask": 500,
"best_bid": 96015.9,
"best_ask": 96016,
"bids": [[96015.9, 412300.5], [96015.8, 51020.3], …],
"asks": [[96016, 388120.2], [96016.1, 20410.7], …],
"walls_bid": [[95900, 2410000]],
"walls_ask": [[96500, 1980000]],
"depth_bid_usd": 61234567,
"depth_ask_usd": 58765432
}فیلدهای پاسخ
| فیلد | نوع | توضیح |
|---|---|---|
exchange / market / coin | string | صرافی، بازار و کوین |
book_ts / age_sec / stale | int / int / boolean | زمان دفتر، سن آن به ثانیه و پرچم stale (قدیمیتر از 30 s) |
source / depth_limited | string / boolean | منبع دفتر — ws یا rest؛ depth_limited — عمق محدود |
levels_bid / levels_ask | int | تعداد سطوح دفتر در هر سمت |
best_bid / best_ask | number | بهترین bid و ask |
bids / asks | [number, number][] | 10 سطح برتر: [قیمت، مبلغ به USD] |
walls_bid / walls_ask | [number, number][] | بزرگترین دیوارها: [قیمت، مبلغ به USD] |
depth_bid_usd / depth_ask_usd | number | عمق کل هر سمت در ±50% بهترین قیمت، USD |