API de criptomoedas: tipos de API de dados de mercado cripto e como escolher uma para operar
Em resumo
- Uma API de criptomoedas dá ao seu código dados de mercado: preços, livros de ofertas, taxas de financiamento, transações on-chain e cotações de mercados de previsão. A API de uma exchange cobre uma plataforma e envia ordens com uma chave; uma API de dados de mercado reúne várias plataformas em um único formato.
- Escolha uma API por nove critérios: cobertura de plataformas e redes, atualidade, normalização de campos, status de depósitos e saques, profundidade do livro de ofertas, rate limits, preço, documentação e termos de uso dos dados.
- A Genesis API é uma API REST somente leitura: CEX, DEX, on-chain, mercados de previsão e surebets de casas de apostas em um único formato JSON, com planos a partir de US$ 20 por mês. Ela não envia ordens.
Uma API de criptomoedas é uma interface de programação pela qual o código lê dados de mercado cripto ou envia ordens a uma exchange: preços, livros de ofertas, taxas de financiamento (funding), transações da blockchain, cotações de mercados de previsão. Os tipos de API diferem em escopo: a API de uma exchange conhece uma única plataforma e envia ordens com uma chave, uma API de dados de mercado reúne várias plataformas em um único formato e uma API on-chain lê a blockchain.
Tipos de API de criptomoedas
| Tipo de API | O que oferece | Quando você precisa |
|---|---|---|
| API de exchange | Preços, livros de ofertas e negociações de uma exchange; ordens com uma chave | Operar nessa exchange, fluxo de negociações de um par |
| API de dados de mercado | Várias exchanges em um único formato, spreads já calculados | Comparar exchanges, scanners, alertas |
| API on-chain | Transações, transferências, saldos, eventos de contratos | Baleias, fluxos de exchanges, desbloqueios |
| API de DEX | Preços e liquidez de pools, swaps, slippage | Tokens que não estão em CEX, operações DEX – CEX |
| Dados de derivativos | Funding, open interest, preços de futuros | Arbitragem de funding, desequilíbrio de posições |
| APIs de mercados de previsão e de odds | Preços YES e NO, livros de ofertas, odds de casas de apostas | Arbitragem de mercados de previsão, surebets |
APIs de exchanges
A API de uma exchange de criptomoedas é a interface de uma única plataforma e tem duas partes. A parte pública fornece dados de mercado sem chave: na Binance, esses endpoints têm o tipo de segurança NONE, e GET /api/v3/ticker/price retorna o preço de um par. A parte privada — ordens, saldos, histórico de negociações — exige uma chave de API e a assinatura da requisição; na Binance, são os tipos TRADE e USER_DATA (documentação da Binance).
Uma API assim cobre uma única exchange: para comparar o preço de uma moeda em 20 exchanges, são necessárias 20 conexões com formatos e limites diferentes.
APIs de dados de mercado
Uma API de dados de mercado coleta dados de várias exchanges, normaliza e devolve tudo em uma única requisição. A resposta já traz o que a união de plataformas exige: spreads entre exchanges, taxas de funding normalizadas para um mesmo período, open interest por exchange.
APIs on-chain
Uma API on-chain lê a blockchain: transações, transferências de tokens, saldos de endereços, eventos de smart contracts. A camada inferior é um nó da rede: todo cliente Ethereum fala JSON-RPC, em que eth_getBalance retorna um saldo em wei como número hexadecimal e eth_getLogs retorna os eventos de contratos que correspondem a um filtro.
Um nó não sabe quais endereços pertencem a uma exchange, a uma equipe ou a uma baleia; indexadores e serviços de análise on-chain acrescentam esses rótulos. Os dados de que um trader precisa são tratados em API de dados on-chain.
APIs de DEX
Uma API de DEX fornece preços e liquidez de pools em exchanges descentralizadas, swaps e slippage. Quanto maior o swap em relação à liquidez do pool, mais ele move o preço; por isso, uma operação DEX – CEX precisa do slippage para o seu tamanho, e tokens novos exigem a taxa do token e uma verificação de honeypot. Mais em API de DEX.
Dados de derivativos: funding e open interest
Futuros perpétuos exigem a taxa de funding, o open interest (o volume de posições abertas) e o preço do futuro ao lado do spot. As exchanges liquidam o funding a cada 8, 4 ou 1 hora, então as taxas são comparadas depois de normalizadas para um mesmo período. Mais em API de taxas de funding e API de open interest.
APIs de mercados de previsão e de odds
As plataformas de previsão fornecem preços de contratos YES e NO e livros de ofertas. Na Polymarket, os dados públicos de mercado dispensam credenciais, enquanto uma ordem exige autenticação e assinatura da carteira (documentação da Polymarket).
Os formatos também diferem aqui: o livro de ofertas da Kalshi contém apenas bids, e o ask de YES é US$ 1 menos o melhor bid de NO, de modo que um bid de NO de US$ 0,56 significa um ask de YES de US$ 0,44 (documentação da Kalshi). As odds das casas de apostas são comparadas aos preços YES e NO por meio da probabilidade implícita — veja API da Polymarket e API da Kalshi e API de odds esportivas.
REST e WebSocket
Uma API REST responde a uma requisição com um snapshot filtrado do seu jeito, e as atualizações vêm por polling periódico.
Um WebSocket mantém a conexão aberta, e o servidor envia cada negociação e cada mudança do livro de ofertas. Em troca, você processa o fluxo sem lacunas, reconecta após quedas e reconstrói o livro a partir de um snapshot mais atualizações, e a Kalshi exige autenticação para conectar, mesmo em canais públicos. Reações em menos de um segundo exigem WebSocket; scanners e alertas sobre mais de 20 exchanges funcionam via REST.
A Genesis API é somente REST, sem WebSocket nem webhooks: toda requisição é um GET, as respostas são compactadas em gzip em JSON e os dados são atualizados a cada meta.freshness_sec segundos. Se você repetir uma requisição do conjunto completo, sem filtros, com o ETag anterior em If-None-Match, recebe um 304 sem corpo quando nada mudou, e essa resposta não consome cota. Os padrões de polling estão em Boas práticas de polling de API.
Como escolher uma API de criptomoedas: checklist
Os seis primeiros critérios aparecem em uma resposta real da API; o restante está na documentação e na tabela de preços.
| Critério | O que verificar |
|---|---|
| Cobertura de plataformas e redes | Suas exchanges, spot e futuros, DEXes e redes |
| Atualidade e latência | Hora de construção na resposta, passo de atualização, idade do livro de ofertas |
| Normalização de campos | Tickers, unidades, porcentagens e hora consistentes |
| Status de depósitos e saques | Indicadores de depósito e saque por exchange e rede |
| Profundidade do livro de ofertas | Preço de execução para o seu tamanho |
| Rate limits e cotas | Requisições por segundo, chamadas por período, o que conta como chamada |
| Preço | Plano ou pagamento por chamada, o que acontece acima do limite |
| Documentação e OpenAPI | Exemplos de requisição e resposta, uma especificação |
| Termos de uso dos dados | Se você pode criar seu próprio produto com os dados |
Cobertura e atualidade
Confira a cobertura com a sua própria lista: se o seu bot trabalha com MEXC e Gate, uma API que não tenha uma das duas não serve. A atualidade dos dados é quantos segundos se passaram desde a construção do snapshot; a latência é todo o caminho de uma negociação na exchange até o seu código. Com um snapshot de um minuto, o bot vê spreads que já não existem.
Normalização de campos
O mesmo par BTC/USDT é escrito de formas diferentes nas APIs das exchanges: BTCUSDT na Binance, BTC-USDT na OKX (o perpétuo é BTC-USDT-SWAP), BTC_USDT na Gate. A Binance retorna os preços como strings ("price": "4.00000200" no exemplo da documentação) e a hora em milissegundos. Seu código precisa lidar com cada uma dessas diferenças.
Uma API de dados de mercado leva os campos a uma só forma, como nesta entrada de /funding/rates da documentação da Genesis API:
{
"coin": "TON",
"exchanges": [
{
"exchange": "MEXC",
"funding_pct": 0.02,
"funding_8h_pct": 0.04,
"next_payout": "00:00",
"interval": "4h",
"price": 2.184,
"trade_url": "https://futures.mexc.com/exchange/TON_USDT"
}
]
}
A MEXC liquida o funding dessa moeda a cada 4 horas, e a taxa de 0,02% por intervalo é normalizada para 8 horas em funding_8h_pct: 0,02 × 8 / 4 = 0,04% (veja Taxas de funding).
Status de depósitos e saques
Uma operação spot entre exchanges só é executável se a moeda puder ser sacada da exchange de compra e depositada na de venda. Na Binance, os status das redes vêm de GET /sapi/v1/capital/config/getall, um endpoint USER_DATA assinado que exige a chave de API da sua conta (documentação da Binance). Na Genesis API, os status chegam em cada linha de Spot – Spot como withdraw_enabled_buy e deposit_enabled_sell (documentação de Spot — Spot).
Profundidade do livro de ofertas
O spread nos melhores preços mostra a distância no topo do livro, enquanto uma negociação de US$ 5.000 percorre vários níveis da profundidade de mercado. No exemplo da documentação da Genesis API para /orderbooks/spreads/spot-futures, o spread de BTC é 0,031% nos melhores preços e 0,0202% depois de percorrer os livros para US$ 5.000. O endpoint Preços de execução retorna preços de execução para US$ 500–10.000; mais em API de livro de ofertas cripto.
Limites, preço e documentação
Os limites são contados de formas diferentes. Na Binance, cada endpoint tem um peso, requisições sobre muitos símbolos pesam mais, e um IP que continua enviando requisições após um 429 é banido por de 2 minutos a 3 dias (limites da Binance). Para uma API de dados, verifique a cota de chamadas, o rate limit por segundo e o que conta como chamada: na Genesis API, só uma resposta 200 consome cota.
O preço é um plano com cota ou pagamento por chamada; descubra o que acontece acima do limite — um erro 429 ou cobranças extras. Uma especificação OpenAPI é uma descrição da API legível por máquina, usada para gerar um cliente e conectar agentes de IA, e os termos de uso dizem se você pode criar um produto com os dados e o que não pode revender.
Verificação com uma requisição
Este script baixa o conjunto completo de Spot – Spot (disponível em todos os planos da Genesis API) e, com uma única resposta, verifica a cobertura, a idade do snapshot e a parcela de operações transferíveis:
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
r = requests.get(BASE + "/arbitrage/spot-spot",
headers=HEADERS, timeout=15)
r.raise_for_status()
body = r.json()
rows, meta = body["data"], body["meta"]
# Cobertura: quais exchanges aparecem nas operações
venues = {x["exchange_buy"] for x in rows}
venues |= {x["exchange_sell"] for x in rows}
print("exchanges in response:", len(venues), sorted(venues))
# Atualidade: idade do snapshot e passo de atualização do plano
age = time.time() - meta["updated_at"]
print(f"snapshot {age:.0f} s old, plan step {meta['freshness_sec']} s")
# Transferência: saques abertos na compra, depósitos abertos na venda
ok = [x for x in rows
if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
print(f"transferable setups: {len(ok)} of {len(rows)}")
As novas tentativas em 429 e 503 vêm da função get_json de Respostas e erros da Genesis API. Depois, confira preços e status de 3–5 operações nas exchanges por meio de trade_url_buy e trade_url_sell.
Construir por conta própria ou usar uma API pronta
Para uma ou duas exchanges mais operação, o natural é o seu próprio código sobre as APIs delas. Para 20 exchanges com spot e futuros, isso significa até 40 conectores de dados de mercado: na Binance, spot e futuros USDⓈ-M são APIs separadas, api.binance.com e fapi.binance.com. Cada conector carrega snapshots REST, um fluxo WebSocket com reconexões, limites próprios e formato de símbolo próprio, e ainda vem a unificação: as moedas são casadas por contrato e rede, porque um mesmo ticker pode ser tokens diferentes em exchanges diferentes.
| Tarefa | Seu código sobre APIs de exchanges | Genesis API |
|---|---|---|
| Enviar ordens | O único caminho: a API de trading da exchange | Não, somente leitura |
| Cada negociação de um par | WebSocket da exchange | Não, snapshots a cada 60–5 s |
| Spreads em mais de 20 exchanges | Até 40 conectores mais a unificação | Uma requisição |
| Status de depósitos e saques | Um endpoint por exchange, com chave na Binance | Campos na linha da operação |
| DEX, on-chain, mercados de previsão | Nós, indexadores, APIs das plataformas | O mesmo formato JSON |
As abordagens se combinam: uma API de dados encontra as operações, e a posição é aberta na exchange à mão ou pela API de trading dela, com uma chave sem permissão de saque (veja Como proteger sua conta de exchange de criptomoedas). Um bot com alertas no Telegram é construído em Bot de arbitragem de criptomoedas em Python.
Onde a Genesis API se encaixa
A Genesis API é a API REST dos dados da Genesis Arbitrage: CEX, DEX, on-chain, mercados de previsão e surebets de casas de apostas em um único formato JSON, com a chave no cabeçalho X-API-Key. Ela serve os mesmos dados que o site publica, por mais de 35 endpoints (37 operações na especificação), e apenas lê dados.
| Dados | Exemplo de endpoint | Planos de API |
|---|---|---|
| Spreads CEX | /arbitrage/spot-spot | Todos |
| DEX e cross-chain | /arbitrage/dex-spot | Pro, Max |
| Livros de ofertas | /orderbooks/exec | Pro, Max |
| Funding e OI | /funding/rates | Todos |
| On-chain | /onchain/{section} | Start, Pro, Max |
| Mercados de previsão e surebets | /predictions/arbitrage | Start: exact, dutch; Pro, Max: llm, sport |
Cobertura: mais de 20 exchanges CEX (Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, Kraken, WhiteBit, Coinbase, CoinW, edgeX, HTX, Hyperliquid e outras), funding de mais de 1.000 moedas normalizado para 8 horas, open interest em mais de 13 exchanges de futuros. Os mercados de previsão são Polymarket, Kalshi, Limitless, Predict.fun e Opinion; o modo sport constrói surebets de casas de apostas em 13 plataformas, apenas pré-jogo.
| Plano | Chamadas por mês | Requisições por segundo | Atualidade |
|---|---|---|---|
| Trial, US$ 20/mês | 500 K | 1 | 60 s |
| Start, US$ 50 | 2 M | 2 | 30 s |
| Pro, US$ 100 | 5 M | 5 | 10 s |
| Max, US$ 200 | 10 M | 15 | 5 s |
Os planos de API são separados da assinatura do site; o pagamento é em cripto, com 10% de desconto por 3 meses e 20% por 6. Acima dos limites, o servidor retorna 429 e não cobra nada, e um endpoint fora do seu plano retorna 403 plan_restricted. Compare os planos em Preços da Genesis API; as regras estão em Planos e limites.
Cada seção da documentação tem sua própria URL com parâmetros, campos, um exemplo de curl e um formulário Testar. Para programas e agentes de IA, há a especificação OpenAPI 3.1 e a referência llms-full.txt; a configuração é descrita em Genesis API para agentes de IA. Você pode criar seus próprios serviços, bots e painéis sobre a Genesis API; não pode revender os dados brutos como estão.
A primeira requisição — um plano, uma chave no seu perfil e um GET com X-API-Key — está no início rápido, e os fundamentos na lição O que é uma API de criptomoedas e o que você pode automatizar. Sem código, os mesmos dados estão nas tabelas do site e nos alertas do Telegram.
Perguntas e respostas
Existe uma API de criptomoedas gratuita?
Sim: as APIs públicas das exchanges fornecem preços, livros de ofertas e negociações de graça e sem chave (na Binance, os endpoints NONE), mas cada uma cobre uma única exchange. A Genesis API não tem plano gratuito: o Trial custa US$ 20 por mês por 500 K chamadas.
Preciso de um SDK para usar uma API de criptomoedas?
Para uma API REST, um cliente HTTP basta: curl, requests em Python ou fetch em JavaScript. A Genesis API não tem SDK oficial, e toda requisição é um GET com um único cabeçalho; você pode gerar um cliente tipado a partir da especificação OpenAPI 3.1.
Posso operar por meio de uma API de dados de mercado?
Não, se a API for somente leitura, como a Genesis API: ela encontra operações, mas não envia ordens. As ordens passam pela exchange, à mão ou pela API de trading dela com chave e assinatura (na Binance, endpoints TRADE), o que fica fora da Genesis API e é por sua conta e risco.
Como obtenho o preço de uma criptomoeda por uma API?
O endpoint público de uma exchange retorna o preço de um par nessa exchange: na Binance, é GET /api/v3/ticker/price, e o preço chega como string. Os preços de uma moeda em todas as exchanges, com status de depósitos e saques, vêm de /coins/search?query=BTC na Genesis API (veja Busca de moedas).