Genesis Arbitrage

Genesis Arbitrage · · 10 min de leitura

O que é uma API de criptomoedas e o que automatizar

Em resumo

  • Uma API de criptomoedas é uma interface de programação pela qual seu programa pede dados de mercado e recebe uma resposta JSON: o mesmo spread que você vê na tabela do site, entregue nos campos exchange_buy, exchange_sell e spread_pct.
  • A API de uma exchange cobre os dados e a conta de uma única plataforma, uma API de dados de mercado reúne muitas exchanges em um formato único e uma API on-chain lê a blockchain. A Genesis API é uma API de dados de mercado somente de leitura.
  • Com uma API, o trader automatiza o monitoramento de spreads, funding e open interest, os alertas, o registro de sinais, os painéis e a pesquisa histórica.
  • Sem experiência, mantenha a execução de ordens e as retiradas manuais: os snapshots de dados ficam atrasados em relação à exchange, e um erro no seu código se repete a cada ciclo.

Uma API de criptomoedas é uma interface de programação que seu código usa para pedir dados do mercado cripto e receber uma resposta com a qual consegue trabalhar: preços, spreads entre exchanges, taxas de financiamento (funding), open interest. Uma pessoa lê esses números em uma tabela; um programa os recebe como campos JSON e pode compará-los com um limite, registrá-los ou enviar um alerta na hora. A definição geral está no verbete do glossário API.

Requisição e resposta

Trabalhar com uma API é trocar duas mensagens: seu programa envia uma requisição a um endereço e o servidor devolve uma resposta. O exemplo mais curto é a verificação de status da Genesis API, que não precisa de chave:

curl "https://api.genesisarbitrage.com/health"
{"ok":true}

curl é um programa de linha de comando para requisições HTTP; curl --version mostra se ele está instalado. As requisições de dados exigem uma chave de API, uma string com a qual o servidor identifica sua conta e seu plano. Um exemplo ilustrativo: pares Spot – Spot da moeda FUEL, com a chave lida da variável de ambiente GENESIS_API_KEY:

URL="https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
curl "$URL?coin=FUEL" -H "X-API-Key: $GENESIS_API_KEY"
{
  "success": true,
  "data": [
    {
      "coin": "FUEL",
      "exchange_buy": "ByBit",
      "exchange_sell": "Gate",
      "price_buy": 0.0007029,
      "price_sell": 0.0007037,
      "spread_pct": 0.11,
      "withdraw_enabled_buy": true,
      "deposit_enabled_sell": true,
      …
    }
  ],
  "meta": {
    "count": 1,
    "updated_at": 1794675861,
    "freshness_sec": 60,
    "plan": "trial"
  }
}

A resposta traz um par: comprar FUEL na ByBit a 0,0007029 e vender na Gate a 0,0007037. O spread já vem calculado em spread_pct: (0,0007037 − 0,0007029) / 0,0007029 × 100 ≈ 0,11%. Os flags withdraw_enabled_buy e deposit_enabled_sell mostram que as retiradas da ByBit e os depósitos na Gate estão abertos, e meta.updated_at informa quando o snapshot foi gerado. A tabela Spot – Spot mostra os mesmos números, e cada campo está descrito na seção Spot — Spot da documentação.

O endereço da requisição é composto por uma URL base, o caminho de um endpoint e parâmetros, enquanto a chave segue separada, no cabeçalho X-API-Key. A aula 2 detalha cada parte da requisição, os códigos de status e a leitura de JSON, e mostra como definir a variável da chave.

Esse tipo de troca, uma requisição seguida de uma resposta com um snapshot de dados, chama-se REST API. Para obter dados novos, envia-se a requisição de novo: a Genesis API atualiza sua saída a cada meta.freshness_sec segundos, de 60 no Trial a 5 no Max. As exchanges também oferecem um segundo canal, o WebSocket: a conexão fica aberta e o servidor envia negociações e mudanças do livro de ofertas assim que ocorrem, como nos streams da Binance. A Genesis API não tem WebSocket.

Tipos de API de criptomoedas

As APIs de criptomoedas diferem pela origem dos dados e pelo que se pode fazer com elas:

Uma comparação de seis tipos de API, REST versus WebSocket e uma lista de nove pontos para escolher estão no guia tipos de API de criptomoedas e como escolher.

O que um trader pode automatizar

Automatize o que você repete por uma regra fixa: abrir uma tabela, comparar um número com um limite, anotar o resultado. Um programa faz isso em intervalos regulares e não pula as horas da madrugada.

TarefaO que o programa fazDados da Genesis API
Monitoramento de spreadsPares acima de um limite com depósitos e retiradas abertos/arbitrage/spot-spot, /arbitrage/spot-futures
FundingCompara as taxas das exchanges normalizadas para 8 horas/funding/rates, /funding/spread
Open interestDetecta variações bruscas do OI entre 5 minutos e 1 hora/market/open-interest
AlertasAvisa você no Telegram quando uma condição é atendidaQualquer endpoint de dados
RegistroSalva cada par encontrado com o carimbo de data e horaA resposta e meta.updated_at
PainelMostra suas colunas e limites em uma página suaRequisições do seu servidor
Pesquisa históricaProcura padrões em dados passados/funding/analytics/daily (Pro, Max)

Alertas costumam ser o primeiro projeto: o programa consulta um endpoint no máximo com a frequência de meta.freshness_sec e avisa você quando um spread ou uma taxa cruza seu limite. Sem código, sinais parecidos vêm dos alertas do Telegram da Genesis Arbitrage no plano Pro do site.

Um registro permite testar uma ideia antes de arriscar dinheiro. Um exemplo ilustrativo: um bot anota a cada 30 segundos os pares com spread de 1% ou mais, ou seja, 86.400 / 30 = 2.880 snapshots por dia. Eles mostram quantos pares duraram mais de um minuto e quantos sumiram até a consulta seguinte.

Para o histórico, a Genesis API oferece a análise de funding, com até um ano de somas diárias do funding liquidado em 13 exchanges, e o histórico de slippage do livro de ofertas; ambos estão nos planos Pro e Max. A Genesis API não tem candles históricos: quem os serve são as APIs das exchanges, na Binance por GET /api/v3/klines com até 1.000 candles por requisição (documentação da Binance). Seu programa monta sozinho o histórico de spreads entre exchanges a partir dos snapshots do seu registro.

O que não automatizar sem experiência

Duas operações custam caro quando dão errado: a execução de ordens e as retiradas.

Execução de ordens

Um bot que envia ordens pela API de trading de uma exchange erra tantas vezes quanto roda: um erro na condição de entrada com consulta a cada 10 segundos gera 3.600 / 10 = 360 ordens por hora. Os dados também chegam atrasados: um snapshot da Genesis API é atualizado a cada 60 a 5 segundos, conforme o plano, os livros de ofertas ficam de 5 a 20 segundos atrás da exchange, e o spread pode fechar nesse intervalo. A Genesis API não envia ordens: ela encontra os pares, e você abre a operação na exchange por conta própria.

Retiradas

Uma chave de exchange com permissão de retirada permite que qualquer pessoa que a obtenha tire fundos da conta, então o vazamento de uma chave assim pode custar todo o saldo. Bots que leem dados ou fazem trading não precisam dessa permissão. Na Binance, uma chave de API nova nem sequer pode operar por padrão: a permissão de trading é ativada separadamente.

Site, APIs de exchange ou Genesis API

TarefaMelhor opçãoPor quê
Ver pares e gráficosSite da Genesis ArbitrageTabelas e filtros, sem código
Sinais sem programarAlertas do Telegram no siteLimites definidos na interface
Suas próprias regras em mais de 20 exchangesGenesis APISpreads calculados, formato único
Ordens, saldos, retiradasAPI da exchangeSó a exchange aceita ordens
Cada negociação em tempo realWebSocket da exchangeA Genesis API serve snapshots a cada 60–5 s
Candles passadosAPI da exchangeA Genesis API não tem candles
Histórico de funding em 13 exchangesGenesis API, Pro e MaxAté um ano de somas diárias, formato único

Uma configuração prática para começar: a Genesis API encontra um par, seu bot envia um alerta e você confere o livro de ofertas da exchange e abre a operação por conta própria. Os planos da Genesis API vão do Trial, a US$ 20 por mês (500K chamadas, atualização de 60 s), ao Max, a US$ 200 (10M, 5 s), e não há plano gratuito. Compare-os na página de preços da Genesis API.

O que você vai precisar no restante do curso

As aulas se apoiam umas nas outras:

Experimente você mesmo

  1. Envie uma requisição sem chave

    Execute curl "https://api.genesisarbitrage.com/health" em um terminal. A resposta {"ok":true} significa que a requisição chegou e o servidor respondeu em JSON.

  2. Relacione a tabela aos campos

    Abra a tabela Spot – Spot e a seção Spot — Spot da documentação. Encontre os campos de exchanges, preços, spread e status das transferências: exchange_buy, price_sell, spread_pct, withdraw_enabled_buy.

  3. Liste suas tarefas de rotina

    Pegue três coisas que você faz todo dia e classifique cada uma com a tabela acima: site, Genesis API ou API da exchange.

  4. Encontre o endpoint para uma tarefa

    Para uma tarefa da Genesis API, encontre o endpoint na documentação e anote os parâmetros de que precisa, como coin e min_spread. Você enviará essa requisição na aula 2.