Genesis API Documentation

Everything you need to integrate: authentication, limits, endpoints and response schemas.

DocumentationQuickstart

Quickstart

1. Get an API key

Subscribe on the pricing page — the key appears in your dashboard. It is shown once, so store it right away.

2. Make your first request

Pass the key in the X-API-Key header. Examples in curl, Python and 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. Parse the response

Every successful response is wrapped in one envelope: the data array and the meta block.

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