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.
GET
https://api.genesisarbitrage.com/v1/orderbooks/spreads/{dataset}?coin={coin}&volume=5000Testar
GET
/v1/orderbooks/spreads/spot-futures?coin=BTC&volume=5000A 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 |
|---|---|---|
{dataset} | string | Dataset no caminho: spot-spot, spot-futures, futures-futures, dex-spot ou dex-futures |
coin | string | Ticker da moeda (obrigatório) |
volume | number | 0 (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
| Campo | Tipo | Descrição |
|---|---|---|
… | Todos os campos da linha do dataset — como em seu endpoint | |
order_delta.volume | number | Volume de cálculo, USD (0 — melhores preços) |
order_delta.buy_price / sell_price | number | null | Par CEX: preço de compra e venda para este volume |
order_delta.side / cex_price | string / number | null | Linha DEX: o lado da CEX (sell ou buy) e o preço de execução |
order_delta.spread_pct | number | null | Spread após a execução pelos books, % |
order_delta.status | string | ok; no_book — sem book; exhausted — o book não foi preenchido |