Genesis Arbitrage

Genesis Arbitrage · · 12 min de leitura

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_pct em /arbitrage/*, a transferência da moeda são os flags de depósito e saque mais network e contract, 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, e age_sec e stale informam 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

PerguntaEndpointCampos
Há diferença de preço/arbitrage/*spread_pct, price_buy, price_sell
Dá para mover a moedaa mesma linha de /arbitrage/spot-spotwithdraw_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-interestdirection, 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:

VolumeCompra → vendaOrder-book ΔEm dólares
00,4002 → 0,40581,3993%—
US$ 5000,4004 → 0,40551,2737%US$ 6,37
US$ 2.5000,4012 → 0,40410,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çãoCamposPlanos
Fluxos de moedas de e para exchanges/onchain/coin-trafficdirection, target, total_usdStart, Pro, Max
Desbloqueios de tokens/onchain/unlocksunlock_value_usd, hours_leftStart, Pro, Max
Open interest por exchange/market/open-interestoi_usd, oi_change_1h, price_change_1hTodos

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.

PontoCamposO par falha se
1. Diferença de preçospread_pcto spread menos duas taxas fica abaixo do limite
2. Transferênciawithdraw_enabled_buy, deposit_enabled_sell, contractsaques ou depósitos estão fechados, ou o contrato não confere
3. Livro de ofertasorder_delta.status, order_delta.spread_pcto status não é ok ou o que sobra está abaixo do limite
4. Atualidademeta.updated_at, age_sec, staleo 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

PlanoAtualidadeDados de arbitragem
Trial, US$ 20 por mês60 sSpot – Spot, Spot – Futures, Futures – Futures, taxas e spread de funding, open interest, Fair – Last, pumps, busca de moedas
Start, US$ 5030 sTudo do Trial mais ações, seções on-chain /onchain/{section}, arbitragem de previsões nos modos exact e dutch
Pro, US$ 10010 sTodos os endpoints: livros de ofertas e Order-book Δ, DEX – Spot, DEX – Futures, Cross-chain, análise de funding
Max, US$ 2005 sOs 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

  1. 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.

  2. Aplique os pontos 1 e 2

    Subtraia duas taxas supostas de 0,1% de spread_pct e confira withdraw_enabled_buy e deposit_enabled_sell. Compare contract com a resposta de /coins/search para essa moeda.

  3. Aplique o ponto 3

    No Pro ou Max, peça /orderbooks/spreads/spot-spot com essa moeda e volume=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.

  4. Aplique o ponto 4

    Subtraia meta.updated_at do tempo unix atual: date +%s o mostra em um terminal.

  5. 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.