Dados de API para arbitragem: spreads, livros e funding
Em resumo
- Cada pergunta do trader tem seu endpoint: a diferença de preço é
spread_pctem/arbitrage/*, a transferência da moeda são os flags de depósito e saque maisnetworkecontract, a execução para o seu volume está em/orderbooks/*e o caso do funding, em/funding/*. - O spread da linha é calculado a partir das últimas negociações. No exemplo ilustrativo, 1,5% sobre US$ 2.500 cai para 0,72% depois de percorrer os livros de ofertas e para cerca de 0,52%, uns US$ 13, depois de duas taxas taker de 0,1%.
- Cada resposta traz seus horários:
meta.updated_até o momento em que o snapshot foi construído,meta.freshness_secé o passo de atualização do seu plano, eage_secestaleinformam a idade do livro de ofertas. - Um par é verificado em quatro pontos: diferença de preço, transferência, livro de ofertas e atualidade. Se qualquer um falhar, a entrada é cancelada.
- A arbitragem CEX, o funding e o open interest estão em todos os planos da Genesis API, as seções on-chain começam no Start, e os livros de ofertas e os dados DEX vêm com Pro e Max.
Os dados de arbitragem de criptomoedas respondem a cinco perguntas: há diferença de preço, dá para mover a moeda, o livro de ofertas tem profundidade para o seu volume, o funding paga e o que os grandes players estão fazendo. Na Genesis API, cada pergunta tem seu próprio endpoint e alguns campos de resposta. A primeira requisição e o envelope success, data, meta estão na lição 2; esta lição trata de quais campos ler e em que ordem.
Pergunta do trader → endpoint → campos
| Pergunta | Endpoint | Campos |
|---|---|---|
| Há diferença de preço | /arbitrage/* | spread_pct, price_buy, price_sell |
| Dá para mover a moeda | a mesma linha de /arbitrage/spot-spot | withdraw_enabled_buy, deposit_enabled_sell, network, contract |
| O livro tem profundidade suficiente | /orderbooks/* | order_delta.spread_pct, order_delta.status |
| O funding paga | /funding/* | spread_pct, interval_1, interval_2, next_payout_1 |
| O que os grandes players estão fazendo | /onchain/*, /market/open-interest | direction, total_usd, oi_change_1h |
O asterisco indica um grupo: /arbitrage/* reúne sete endpoints, de Spot – Spot a ações, enquanto /orderbooks/* e /funding/* reúnem seis cada um. As seções abaixo seguem a ordem em que um par é verificado.
Há diferença de preço: spread_pct
Uma linha da documentação de Spot — Spot: FUEL, compra na ByBit a 0,0007029, venda na Gate a 0,0007037, spread_pct 0,11. Verificação: (0,0007037 − 0,0007029) / 0,0007029 × 100 ≈ 0,11%. O spread da linha é calculado a partir de price_buy e price_sell, os preços das últimas negociações; no site, é a coluna Preço.
Nos conjuntos de dados DEX – Spot e DEX – Futures o sinal importa: o mais significa que o token está mais barato na DEX, o menos, que está mais caro. Os parâmetros e campos dos sete conjuntos estão no guia de endpoints de arbitragem.
spread_pct responde só à primeira pergunta: não contém taxas, transferência nem livro de ofertas.
Dá para mover a moeda: depósitos, saques, rede e contrato
Um par spot entre exchanges exige uma transferência: você compra a moeda em uma exchange, saca e deposita na outra. Por isso a linha tem dois flags para ler: withdraw_enabled_buy, se os saques estão abertos na exchange de compra, e deposit_enabled_sell, se os depósitos estão abertos na exchange de venda. A requisição não tem parâmetros para eles, então o seu código filtra as linhas.
network e contract mostram se é o mesmo token. Moedas diferentes podem negociar sob o mesmo ticker em exchanges diferentes, então compare o endereço do contrato com as páginas de saque e depósito das duas exchanges. Os contratos de uma moeda por rede, e as exchanges que usam cada um, vêm de /coins/search em qualquer plano (Coin Search).
Nos conjuntos DEX os flags pertencem ao lado CEX: deposit_enabled e withdraw_enabled. No Cross-chain o token se move por uma ponte entre as redes buy.chain e sell.chain, então não há flags de exchange.
O livro de ofertas tem profundidade: spread da linha e spread após a execução
Uma ordem a mercado percorre o livro de ofertas: uma compra consome asks para cima a partir do melhor, uma venda consome bids para baixo. Quanto maior o volume, pior o preço médio e menos sobra do spread da linha. O Order-book Δ, /orderbooks/spreads/{dataset} nos planos Pro e Max, retorna o que sobra para o seu volume (documentação).
Exemplo ilustrativo: moeda LMN, compra na OKX a 0,4000, venda na Bitget a 0,4060. Spread da linha: (0,4060 − 0,4000) / 0,4000 × 100 = 1,5%. Requisição a /orderbooks/spreads/spot-spot com coin=LMN em diferentes valores de volume:
| Volume | Compra → venda | Order-book Δ | Em dólares |
|---|---|---|---|
0 | 0,4002 → 0,4058 | 1,3993% | — |
| US$ 500 | 0,4004 → 0,4055 | 1,2737% | US$ 6,37 |
| US$ 2.500 | 0,4012 → 0,4041 | 0,7228% | US$ 18,07 |
| US$ 10.000 | — | exhausted | — |
volume=0 usa o melhor ask da OKX e o melhor bid da Bitget: as melhores ordens ficam piores que as últimas negociações, então 0,1 ponto percentual some mesmo no menor volume. Com US$ 2.500, o preço médio de compra é 0,4012 e o de venda, 0,4041: (0,4041 − 0,4012) / 0,4012 × 100 ≈ 0,7228%. Com US$ 10.000, os bids da Bitget acabaram e order_delta.status é exhausted.
Cada exchange cobra uma taxa taker; o exemplo supõe 0,1% (maker e taker). Com US$ 2.500 você fica com 0,7228 − 2 × 0,1 = 0,5228%, ou 2.500 × 0,5228 / 100 ≈ US$ 13,07. As taxas de saque não aparecem nas respostas: consulte-as na página de saques da exchange e subtraia separadamente.
No Trial e no Start os endpoints de livros de ofertas retornam 403 plan_restricted, então você confere o livro no terminal da exchange. O preço de execução e o slippage são explicados em API de livro de ofertas de criptomoedas, e os seis endpoints, no guia de endpoints de livros de ofertas.
O funding paga: spread, intervalos e pagamentos
A arbitragem de funding é um short onde a taxa de financiamento (funding) é mais alta e um long onde é mais baixa: os movimentos de preço mudam pouco o resultado e a diferença de taxas vai se acumulando. Os candidatos vêm de /funding/spread em qualquer plano: o melhor par de exchanges em best e seu spread_pct (Funding spread).
O spread do par não diz quando nem com que frequência os pagamentos acontecem. interval_1 e interval_2 são os intervalos de funding das duas exchanges, e next_payout_1 e next_payout_2 são os horários dos próximos pagamentos em UTC: só uma posição aberta no momento da liquidação recebe o funding. Taxas com intervalos diferentes são comparadas depois de normalizadas para 8 horas, que é o campo funding_8h_pct em /funding/rates.
Exemplo ilustrativo: um spread de 0,03% por 8 horas, com uma posição de US$ 5.000 em cada ponta. Uma liquidação rende 5.000 × 0,03 / 100 = US$ 1,5. Quatro operações, abrindo e fechando as duas pontas, custam 4 × 5.000 × 0,1 / 100 = US$ 20 com taxa taker de 0,1%. As taxas se pagam depois de 20 / 1,5 ≈ 13,3 liquidações: são 14 liquidações de oito horas, quase cinco dias, se as taxas se mantiverem.
O histórico mostra se a diferença se mantém: nos planos Pro e Max, /funding/analytics/summary com coin retorna, para cada exchange, sum (funding acumulado), cov (cobertura) e flips (trocas de sinal) para cada período. Os detalhes estão em API de taxa de financiamento (funding) e no guia de endpoints de funding.
O que os grandes players estão fazendo: on-chain e open interest
Os dados on-chain e o open interest explicam por que um par pode fechar antes de você executá-lo. Uma moeda entrando na exchange de venda significa vendedores chegando antes da sua transferência. Um open interest crescente significa novas posições alavancadas, e um movimento brusco contra elas provoca liquidações.
| O que você vê | Requisição | Campos | Planos |
|---|---|---|---|
| Fluxos de moedas de e para exchanges | /onchain/coin-traffic | direction, target, total_usd | Start, Pro, Max |
| Desbloqueios de tokens | /onchain/unlocks | unlock_value_usd, hours_left | Start, Pro, Max |
| Open interest por exchange | /market/open-interest | oi_usd, oi_change_1h, price_change_1h | Todos |
A resposta de exemplo na documentação do Genesis Onchain mostra 18 transferências de LAB para a Gate somando US$ 573.796,98 em 5,69 horas, com direction igual a deposit. Se a LAB tem um par vendendo na Gate nesse momento, esse fluxo é motivo para reduzir o volume ou pular a entrada. Mais em API de dados on-chain e API de open interest.
Atualidade dos dados e carimbos de tempo
Cada resposta traz seu horário: meta.updated_at é o tempo unix em que o snapshot foi construído, e meta.freshness_sec é o passo de atualização do seu plano: 60 segundos no Trial, 30 no Start, 10 no Pro e 5 no Max. A idade do snapshot é o horário atual menos updated_at (atualidade dos dados).
Exemplo ilustrativo: plano Trial, a resposta chegou em 1783802455 e updated_at é 1783802410. O snapshot tem 1783802455 − 1783802410 = 45 segundos: seus pares foram calculados com preços de quase um minuto atrás, e alguns deles podem já ter sumido nas exchanges.
Os livros de ofertas têm relógio próprio: em /orderbooks/book e /orderbooks/coin/{coin} cada livro tem book_ts, age_sec (sua idade em segundos) e stale: true quando passa de 30 segundos. Os livros ficam de 5 a 20 segundos atrás da exchange, então verifique a idade das duas pontas: uma diferença de preço entre um livro novo e um antigo pode ser uma diferença de tempo.
Por que um campo só não basta: a verificação em quatro pontos
Cada campo fecha uma pergunta, e você só entra quando todas estão fechadas. Um spread de 3% com os saques fechados deixa a moeda presa na exchange de compra. Com exhausted, o seu volume não será preenchido. Com um snapshot de 50 segundos, o par pode já ter sumido.
| Ponto | Campos | O par falha se |
|---|---|---|
| 1. Diferença de preço | spread_pct | o spread menos duas taxas fica abaixo do limite |
| 2. Transferência | withdraw_enabled_buy, deposit_enabled_sell, contract | saques ou depósitos estão fechados, ou o contrato não confere |
| 3. Livro de ofertas | order_delta.status, order_delta.spread_pct | o status não é ok ou o que sobra está abaixo do limite |
| 4. Atualidade | meta.updated_at, age_sec, stale | o snapshot ou um livro é mais antigo que o limite |
A função recebe uma linha data de /arbitrage/spot-spot, o objeto order_delta do mesmo par de exchanges (None no Trial e no Start) e o meta da resposta. Os limites são ilustrativos: ajuste-os às suas taxas e ao seu plano.
import time
FEE = 0.1 # taxa taker suposta por ponta, %
MIN_NET = 0.3 # pelo menos 0,3% restante após as taxas
MAX_AGE = 60 # snapshot com no máximo 60 segundos
def check(row, od, meta):
"""Os pontos em que um par Spot – Spot falhou."""
fails = []
if row["spread_pct"] - 2 * FEE < MIN_NET:
fails.append("1: o spread não cobre as taxas")
if not row["withdraw_enabled_buy"]:
fails.append("2: saques fechados na exchange de compra")
if not row["deposit_enabled_sell"]:
fails.append("2: depósitos fechados na exchange de venda")
if od is None:
fails.append("3: livro não verificado (Trial ou Start)")
elif od["status"] != "ok":
fails.append("3: livro — " + od["status"])
elif od["spread_pct"] - 2 * FEE < MIN_NET:
fails.append("3: sobra pouco depois do livro")
if time.time() - meta["updated_at"] > MAX_AGE:
fails.append("4: snapshot mais antigo que MAX_AGE segundos")
return fails
Uma lista vazia significa que o par passou nos quatro pontos. O par LMN com US$ 2.500 passa: 1,5 − 0,2 = 1,3% na linha, 0,7228 − 0,2 = 0,5228% depois do livro e um snapshot de 45 segundos. Com US$ 10.000 a função retorna "3: livro — exhausted". O código não consegue verificar o contrato: você confere o endereço nas páginas de saque e depósito das exchanges, e a idade dos livros das duas pontas vem de /orderbooks/book.
A mesma verificação na tabela do site, sem código, está na lição Spread, profundidade, volume: como ler a tabela, e a consulta periódica da API em um laço, na lição 4.
Quais dados vêm em cada plano
| Plano | Atualidade | Dados de arbitragem |
|---|---|---|
| Trial, US$ 20 por mês | 60 s | Spot – Spot, Spot – Futures, Futures – Futures, taxas e spread de funding, open interest, Fair – Last, pumps, busca de moedas |
| Start, US$ 50 | 30 s | Tudo do Trial mais ações, seções on-chain /onchain/{section}, arbitragem de previsões nos modos exact e dutch |
| Pro, US$ 100 | 10 s | Todos os endpoints: livros de ofertas e Order-book Δ, DEX – Spot, DEX – Futures, Cross-chain, análise de funding |
| Max, US$ 200 | 5 s | Os mesmos endpoints do Pro, com 15 requisições por segundo |
Um endpoint fora do seu plano retorna 403 plan_restricted, e essa resposta não consome cota. As cotas de chamadas e os limites de requisições por segundo estão na página de preços da Genesis API.
Prática
Escolha um par
Na documentação de Spot — Spot, abra o formulário Testar, cole a sua chave e escolha uma linha com spread de 1% ou mais.
Aplique os pontos 1 e 2
Subtraia duas taxas supostas de 0,1% de
spread_pcte confirawithdraw_enabled_buyedeposit_enabled_sell. Comparecontractcom a resposta de/coins/searchpara essa moeda.Aplique o ponto 3
No Pro ou Max, peça
/orderbooks/spreads/spot-spotcom essa moeda evolume=1000, e encontre a linha com o mesmo par de exchanges. No Trial e no Start, abra o livro de ofertas no terminal da exchange.Aplique o ponto 4
Subtraia
meta.updated_atdo tempo unix atual:date +%so mostra em um terminal.Anote o veredito
Qual ponto rejeitaria o par primeiro e quanto do spread sobraria com US$ 1.000.
Perguntas e respostas
De quais dados se precisa para arbitragem de criptomoedas?
Preços da moeda em diferentes exchanges e o spread entre eles, o status de depósitos e saques com a rede e o contrato, livros de ofertas para calcular a execução do seu volume e o horário do snapshot. A arbitragem de funding acrescenta taxas, intervalos e horários de pagamento. Na Genesis API, isso é /arbitrage/*, /orderbooks/* e /funding/*.
Dá para operar pela Genesis API?
Não. A Genesis API só lê dados e não envia ordens: as operações você abre por conta própria nas exchanges.