Genesis API Documentation
Everything you need to integrate: authentication, limits, endpoints and response schemas.
DocumentationCoin order books
Coin order books
TrialStartProMax
A coin's order books on every exchange and market at once — same fields as /orderbooks/book.
GET
https://api.genesisarbitrage.com/v1/orderbooks/coin/{coin}Try it
GET
/v1/orderbooks/coin/BTCThe 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 |
|---|---|---|
{coin} | string | Coin ticker (required) |
Example request
bash
curl "https://api.genesisarbitrage.com/v1/orderbooks/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
| Field | Type | Description |
|---|---|---|
exchange / market / coin | string | Exchange, market and coin |
book_ts / age_sec / stale | int / int / boolean | Book time, its age in seconds and the stale flag (older than 30 s) |
source / depth_limited | string / boolean | Book source — ws or rest; depth_limited — limited depth |
levels_bid / levels_ask | int | Number of book levels per side |
best_bid / best_ask | number | Best 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_usd | number | Total side depth within ±50% of the best price, USD |