مستندات Genesis API

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

مستنداتدفتر سفارش بازار

دفتر سفارش بازار

TrialStartProMax

دفتر سفارش یک بازار، مانند پنجره «دفتر سفارش» سایت: بهترین قیمت‌ها، 10 سطح در هر سمت به $، بزرگ‌ترین دیوارها، عمق در ±50% و سن دفتر. depth_limited — صرافی عمق محدودی منتشر می‌کند، پس حجم‌های بزرگ ممکن است پر نشوند.

GEThttps://api.genesisarbitrage.com/v1/orderbooks/book?exchange=Binance&market=spot&coin={coin}
امتحان درخواست
GET/v1/orderbooks/book?exchange=Binance&market=spot&coin=BTC

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

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

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

پارامترنوعتوضیح
exchangestringصرافی (بدون حساسیت به حروف بزرگ و کوچک)
marketstringspot یا futures
coinstringنماد کوین (الزامی)

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

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 / coinstringصرافی، بازار و کوین
book_ts / age_sec / staleint / int / booleanزمان دفتر، سن آن به ثانیه و پرچم stale (قدیمی‌تر از 30 s)
source / depth_limitedstring / booleanمنبع دفتر — ws یا rest؛ depth_limited — عمق محدود
levels_bid / levels_askintتعداد سطوح دفتر در هر سمت
best_bid / best_asknumberبهترین bid و ask
bids / asks[number, number][]10 سطح برتر: [قیمت، مبلغ به USD]
walls_bid / walls_ask[number, number][]بزرگ‌ترین دیوارها: [قیمت، مبلغ به USD]
depth_bid_usd / depth_ask_usdnumberعمق کل هر سمت در ±50% بهترین قیمت، USD