Genesis API Documentation

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

DocumentationMarket order book

Market order book

TrialStartProMax

One market's order book, as in the site's «Order book» window: best prices, 10 levels per side in $, the largest walls, depth within ±50% and the book's age. depth_limited — the exchange publishes limited depth, so large volumes may not fill.

GEThttps://api.genesisarbitrage.com/v1/orderbooks/book?exchange=Binance&market=spot&coin={coin}
Try it
GET/v1/orderbooks/book?exchange=Binance&market=spot&coin=BTC

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
exchangestringExchange (case-insensitive)
marketstringspot or futures
coinstringCoin ticker (required)

Example request

bash
curl "https://api.genesisarbitrage.com/v1/orderbooks/book?exchange=Binance&market=spot&coin=BTC" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Example response

Response example — one data entry, long values shortened:

json
{
  "exchange": "Binance",
  "market": "spot",
  "coin": "BTC",
  "book_ts": 1794675858,
  "age_sec": 6,
  "stale": false,
  "source": "ws",
  "depth_limited": false,
  "levels_bid": 500,
  "levels_ask": 500,
  "best_bid": 96015.9,
  "best_ask": 96016,
  "bids": [[96015.9, 412300.5], [96015.8, 51020.3], …],
  "asks": [[96016, 388120.2], [96016.1, 20410.7], …],
  "walls_bid": [[95900, 2410000]],
  "walls_ask": [[96500, 1980000]],
  "depth_bid_usd": 61234567,
  "depth_ask_usd": 58765432
}

Response fields

FieldTypeDescription
exchange / market / coinstringExchange, market and coin
book_ts / age_sec / staleint / int / booleanBook time, its age in seconds and the stale flag (older than 30 s)
source / depth_limitedstring / booleanBook source — ws or rest; depth_limited — limited depth
levels_bid / levels_askintNumber of book levels per side
best_bid / best_asknumberBest bid and ask
bids / asks[number, number][]Top 10 levels: [price, USD amount]
walls_bid / walls_ask[number, number][]Largest walls: [price, USD amount]
depth_bid_usd / depth_ask_usdnumberTotal side depth within ±50% of the best price, USD