مستندات Genesis API

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

مستنداتتاریخچه اجرا

تاریخچه اجرا

TrialStartProMax

تاریخچه اسلیپیج از Genesis Charts: برای هر بازار و حجم، اجرا چند بیسیس‌پوینت از میانه دفتر هزینه داشته است. 360 نقطه در هر بازه: 1m — 6 ساعت، 15m — 3.75 روز، 1h — 15 روز، 1d — حدود یک سال (داده از 6 سپتامبر 2026). حداکثر 8 بازار در هر درخواست؛ null — داده‌ای نیست یا دفتر پر نشد.

GEThttps://api.genesisarbitrage.com/v1/orderbooks/exec-history?keys=Binance|spot|{coin}&interval=1h
امتحان درخواست
GET/v1/orderbooks/exec-history?keys=Binance|spot|BTC&interval=1h

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

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

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

پارامترنوعتوضیح
keysstringتا 8 کلید بازار مانند Binance|spot|BTC، با ویرگول
intervalstring1m، 15m، 1h یا 1d (الزامی)

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

bash
curl "https://api.genesisarbitrage.com/v1/orderbooks/exec-history?keys=Binance|spot|BTC&interval=1h" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

نمونه پاسخ

نمونه پاسخ — یک عنصر data، مقادیر بلند کوتاه شده‌اند:

json
{
  "interval": "1h",
  "step_sec": 3600,
  "points": 360,
  "volumes_usd": [500, 1000, 2500, 5000, 10000],
  "last_bucket_ts": 1794672000,
  "series": {
    "Binance|spot|BTC": {
      "buy": [[1, 1, 2, …], [1, 2, 2, …], [2, 3, 4, …], [3, 4, 6, …], [5, 7, 9, …]],
      "sell": [[-1, -1, -2, …], …]
    },
    "Unknown|spot|XYZ": null
  }
}

فیلدهای پاسخ

فیلدنوعتوضیح
interval / step_sec / pointsstring / int / intبازه، گام به ثانیه و تعداد نقاط
volumes_usdnumber[]شبکه حجم‌ها، USD
last_bucket_tsintزمان آخرین بازه؛ نقاط از قدیم به جدید می‌روند و به آن ختم می‌شوند
series{}.buy / sell(int | null)[5][360]برای هر کلید بازار: buy و sell — 5 سری (به‌ازای هر حجم) از 360 مقدار بر حسب bps از میانه دفتر؛ null — کلید ناشناخته