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_sellespread_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:
- API de exchange: dados e acesso à conta de uma única plataforma. A exchange serve preços, livros de ofertas e negociações publicamente, enquanto saldos, ordens e histórico de negociações exigem uma chave e uma requisição assinada. A Binance descreve isso como tipos de segurança:
NONEpara dados de mercado abertos,TRADEpara criar e cancelar ordens,USER_DATApara dados da conta (documentação da Binance). - API de dados de mercado: muitas exchanges e redes em um formato único. Ela serve o que exige combinar plataformas: spreads entre exchanges, taxas de funding normalizadas para um mesmo período, open interest por exchange. A Genesis API é desse tipo e apenas lê dados.
- API on-chain: dados da blockchain, como transações, transferências de tokens e saldos de endereços. Rótulos como "exchange", "equipe do projeto" ou "baleia" vêm de serviços de análise construídos sobre os dados da rede.
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.
| Tarefa | O que o programa faz | Dados da Genesis API |
|---|---|---|
| Monitoramento de spreads | Pares acima de um limite com depósitos e retiradas abertos | /arbitrage/spot-spot, /arbitrage/spot-futures |
| Funding | Compara as taxas das exchanges normalizadas para 8 horas | /funding/rates, /funding/spread |
| Open interest | Detecta variações bruscas do OI entre 5 minutos e 1 hora | /market/open-interest |
| Alertas | Avisa você no Telegram quando uma condição é atendida | Qualquer endpoint de dados |
| Registro | Salva cada par encontrado com o carimbo de data e hora | A resposta e meta.updated_at |
| Painel | Mostra suas colunas e limites em uma página sua | Requisições do seu servidor |
| Pesquisa histórica | Procura 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
| Tarefa | Melhor opção | Por quê |
|---|---|---|
| Ver pares e gráficos | Site da Genesis Arbitrage | Tabelas e filtros, sem código |
| Sinais sem programar | Alertas do Telegram no site | Limites definidos na interface |
| Suas próprias regras em mais de 20 exchanges | Genesis API | Spreads calculados, formato único |
| Ordens, saldos, retiradas | API da exchange | Só a exchange aceita ordens |
| Cada negociação em tempo real | WebSocket da exchange | A Genesis API serve snapshots a cada 60–5 s |
| Candles passados | API da exchange | A Genesis API não tem candles |
| Histórico de funding em 13 exchanges | Genesis API, Pro e Max | Até 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
- Uma chave da Genesis API: escolha um plano na página de preços e obtenha a chave com o botão "Obter chave" no seu perfil; os passos estão no início rápido da Genesis API. Guarde a chave na variável de ambiente
GENESIS_API_KEYe nunca a coloque na URL de uma requisição. - curl para as primeiras requisições pelo terminal.
- Python 3.10+ e a biblioteca
requests(pip install requests) para os scripts das aulas 2 e 4. - A documentação da Genesis API: cada endpoint tem seus parâmetros, campos, um exemplo de curl e um formulário "Testar" que envia a requisição direto da página.
As aulas se apoiam umas nas outras:
- aula 2: sua primeira requisição, com endereço, cabeçalhos, códigos de status e JSON;
- aula 3: quais dados servem a quais decisões, de spreads e livros de ofertas a funding e fluxos on-chain;
- aula 4: um monitor de spreads e funding em Python;
- aula 5: riscos da automação, incluindo dados desatualizados, erros, chaves e agentes de IA.
Experimente você mesmo
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.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.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.
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
coinemin_spread. Você enviará essa requisição na aula 2.