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"
}
}