Documentação da Genesis API
Tudo para integrar: autenticação, limites, endpoints e esquemas de resposta.
DocumentaçãoOrder book do mercado
Order book do mercado
TrialStartProMax
O order book de um mercado, como na janela «Order book» do site: melhores preços, 10 níveis por lado em $, as maiores paredes, a profundidade dentro de ±50% e a idade do book. depth_limited — a exchange publica profundidade limitada, então volumes grandes podem não ser preenchidos.
GET
https://api.genesisarbitrage.com/v1/orderbooks/book?exchange=Binance&market=spot&coin={coin}Testar
GET
/v1/orderbooks/book?exchange=Binance&market=spot&coin=BTCA chave fica só no seu navegador e não é enviada a lugar nenhum além da API.
Cole sua chave e envie uma requisição — mostraremos uma resposta resumida.
Parâmetros da requisição
| Parâmetro | Tipo | Descrição |
|---|---|---|
exchange | string | Exchange (sem distinção de maiúsculas) |
market | string | spot ou futures |
coin | string | Ticker da moeda (obrigatório) |
Exemplo de requisição
bash
curl "https://api.genesisarbitrage.com/v1/orderbooks/book?exchange=Binance&market=spot&coin=BTC" \ -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"
Exemplo de resposta
Exemplo de resposta — um elemento de dados, valores longos abreviados:
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
}Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
exchange / market / coin | string | Exchange, mercado e moeda |
book_ts / age_sec / stale | int / int / boolean | Hora do book, sua idade em segundos e o flag stale (mais antigo que 30 s) |
source / depth_limited | string / boolean | Fonte do book — ws ou rest; depth_limited — profundidade limitada |
levels_bid / levels_ask | int | Número de níveis do book por lado |
best_bid / best_ask | number | Melhor bid e ask |
bids / asks | [number, number][] | Top 10 níveis: [preço, valor em USD] |
walls_bid / walls_ask | [number, number][] | Maiores paredes: [preço, valor em USD] |
depth_bid_usd / depth_ask_usd | number | Profundidade total do lado dentro de ±50% do melhor preço, USD |