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.

GEThttps://api.genesisarbitrage.com/v1/orderbooks/spreads/{dataset}?coin={coin}&volume=5000
Try it
GET/v1/orderbooks/spreads/spot-futures?coin=BTC&volume=5000

The 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

ParameterTypeDescription
{dataset}stringDataset in the path: spot-spot, spot-futures, futures-futures, dex-spot or dex-futures
coinstringCoin ticker (required)
volumenumber0 (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

FieldTypeDescription
…All fields of the dataset's row — as in its endpoint
order_delta.volumenumberComputation volume, USD (0 — best prices)
order_delta.buy_price / sell_pricenumber | nullCEX pair: buy and sell price for this volume
order_delta.side / cex_pricestring / number | nullDEX row: the CEX side (sell or buy) and the execution price
order_delta.spread_pctnumber | nullSpread after executing through the books, %
order_delta.statusstringok; no_book — no book; exhausted — the book did not fill