Documentação da Genesis API

Tudo para integrar: autenticação, limites, endpoints e esquemas de resposta.

DocumentaçãoΔ do order book

Δ do order book

TrialStartProMax

«Δ do order book» para cada linha de uma moeda no dataset de arbitragem escolhido — as mesmas fórmulas da coluna do site. Pares CEX: compra pelos asks da primeira exchange, venda nos bids da segunda, limitado ao spread da linha. Linhas DEX: o sinal do spread define a direção (≥ 0 — venda nos bids da CEX, < 0 — compra nos asks), um sinal invertido resulta em 0. volume = 0 — aos melhores preços do book.

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

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
{dataset}stringDataset no caminho: spot-spot, spot-futures, futures-futures, dex-spot ou dex-futures
coinstringTicker da moeda (obrigatório)
volumenumber0 (padrão) — melhores preços do book, ou 500, 1000, 2500, 5000, 10000

Exemplo de requisição

bash
curl "https://api.genesisarbitrage.com/v1/orderbooks/spreads/spot-futures?coin=BTC&volume=5000" \
  -H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX"

Exemplo de resposta

Exemplo de resposta — um elemento de dados, valores longos abreviados:

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"
  }
}

Campos da resposta

CampoTipoDescrição
…Todos os campos da linha do dataset — como em seu endpoint
order_delta.volumenumberVolume de cálculo, USD (0 — melhores preços)
order_delta.buy_price / sell_pricenumber | nullPar CEX: preço de compra e venda para este volume
order_delta.side / cex_pricestring / number | nullLinha DEX: o lado da CEX (sell ou buy) e o preço de execução
order_delta.spread_pctnumber | nullSpread após a execução pelos books, %
order_delta.statusstringok; no_book — sem book; exhausted — o book não foi preenchido