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.

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

A 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âmetroTipoDescrição
exchangestringExchange (sem distinção de maiúsculas)
marketstringspot ou futures
coinstringTicker 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

CampoTipoDescrição
exchange / market / coinstringExchange, mercado e moeda
book_ts / age_sec / staleint / int / booleanHora do book, sua idade em segundos e o flag stale (mais antigo que 30 s)
source / depth_limitedstring / booleanFonte do book — ws ou rest; depth_limited — profundidade limitada
levels_bid / levels_askintNúmero de níveis do book por lado
best_bid / best_asknumberMelhor 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_usdnumberProfundidade total do lado dentro de ±50% do melhor preço, USD