توثيق Genesis API

كل ما تحتاجه للتكامل: المصادقة والحدود ونقاط النهاية ومخططات الاستجابة.

التوثيقبداية سريعة

بداية سريعة

1. احصل على مفتاح API

اشترك من صفحة الأسعار — يظهر المفتاح في لوحتك. يُعرض مرة واحدة فقط، فاحفظه فوراً.

2. أرسل أول طلب

مرّر المفتاح في ترويسة X-API-Key. أمثلة بـ curl وPython وJavaScript:

bash
curl "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot?min_spread=0.5" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
python
import requests

r = requests.get(
    "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
    headers={"X-API-Key": "gns_live_XXXXXXXXXXXXXXXX"},
    params={"min_spread": 0.5},
)
for row in r.json()["data"]:
    print(row["coin"], row["exchange_buy"], "→", row["exchange_sell"], f"{row['spread_pct']}%")
javascript
const res = await fetch(
  'https://api.genesisarbitrage.com/v1/arbitrage/spot-spot?min_spread=0.5',
  { headers: { 'X-API-Key': 'gns_live_XXXXXXXXXXXXXXXX' } }
);
const { data } = await res.json();
for (const row of data) {
  console.log(row.coin, row.exchange_buy, '→', row.exchange_sell, row.spread_pct + '%');
}

3. اقرأ الاستجابة

كل استجابة ناجحة تأتي في الغلاف نفسه: مصفوفة data وكتلة meta.

json
{
  "success": true,
  "data": [ … ],
  "meta": {
    "count": 214,
    "updated_at": 1783802410,
    "freshness_sec": 10,
    "plan": "pro"
  }
}