Genesis API Documentation
Everything you need to integrate: authentication, limits, endpoints and response schemas.
DocumentationOrder-book Δ
Order-book Δ
TrialStartProMax
«Order-book Δ» for every row of one coin in the chosen arbitrage dataset — the same formulas as the site's column. CEX pairs: buy through the first exchange's asks, sell into the second one's bids, capped at the row's spread. DEX rows: the spread sign sets the direction (≥ 0 — sell into the CEX bids, < 0 — buy from the asks), a flipped sign gives 0. volume = 0 — at the best book prices.
GET
https://api.genesisarbitrage.com/v1/orderbooks/spreads/{dataset}?coin={coin}&volume=5000Try it
GET
/v1/orderbooks/spreads/spot-futures?coin=BTC&volume=5000The key is stored only in your browser and is sent nowhere except the API.
Paste your key and send a request — we'll show a truncated response.
Query parameters
| Parameter | Type | Description |
|---|---|---|
{dataset} | string | Dataset in the path: spot-spot, spot-futures, futures-futures, dex-spot or dex-futures |
coin | string | Coin ticker (required) |
volume | number | 0 (default) — best book prices, or 500, 1000, 2500, 5000, 10000 |
Example request
bash
curl "https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-futures?coin=BTC&volume=5000" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Example response
Response example — one data entry, long values shortened:
json
{
"coin": "BTC",
"exchange_buy": "Binance",
"exchange_sell": "ByBit",
"market_buy": "spot",
"market_sell": "futures",
"price_buy": 96016,
"price_sell": 96046,
"ask_buy": 96016,
"bid_sell": 96045.8,
"spread_pct": 0.031,
"order_delta": {
"volume": 5000,
"buy_price": 96019.8,
"sell_price": 96039.2,
"spread_pct": 0.0202,
"status": "ok"
}
}Response fields
| Field | Type | Description |
|---|---|---|
… | All fields of the dataset's row — as in its endpoint | |
order_delta.volume | number | Computation volume, USD (0 — best prices) |
order_delta.buy_price / sell_price | number | null | CEX pair: buy and sell price for this volume |
order_delta.side / cex_price | string / number | null | DEX row: the CEX side (sell or buy) and the execution price |
order_delta.spread_pct | number | null | Spread after executing through the books, % |
order_delta.status | string | ok; no_book — no book; exhausted — the book did not fill |