Genesis Arbitrage

Genesis Arbitrage · · 15 min de leitura

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 APIO que ofereceQuando você precisa
API de exchangePreços, livros de ofertas e negociações de uma exchange; ordens com uma chaveOperar nessa exchange, fluxo de negociações de um par
API de dados de mercadoVárias exchanges em um único formato, spreads já calculadosComparar exchanges, scanners, alertas
API on-chainTransações, transferências, saldos, eventos de contratosBaleias, fluxos de exchanges, desbloqueios
API de DEXPreços e liquidez de pools, swaps, slippageTokens que não estão em CEX, operações DEX – CEX
Dados de derivativosFunding, open interest, preços de futurosArbitragem de funding, desequilíbrio de posições
APIs de mercados de previsão e de oddsPreços YES e NO, livros de ofertas, odds de casas de apostasArbitragem 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érioO que verificar
Cobertura de plataformas e redesSuas exchanges, spot e futuros, DEXes e redes
Atualidade e latênciaHora de construção na resposta, passo de atualização, idade do livro de ofertas
Normalização de camposTickers, unidades, porcentagens e hora consistentes
Status de depósitos e saquesIndicadores de depósito e saque por exchange e rede
Profundidade do livro de ofertasPreço de execução para o seu tamanho
Rate limits e cotasRequisições por segundo, chamadas por período, o que conta como chamada
PreçoPlano ou pagamento por chamada, o que acontece acima do limite
Documentação e OpenAPIExemplos de requisição e resposta, uma especificação
Termos de uso dos dadosSe 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.

TarefaSeu código sobre APIs de exchangesGenesis API
Enviar ordensO único caminho: a API de trading da exchangeNão, somente leitura
Cada negociação de um parWebSocket da exchangeNão, snapshots a cada 60–5 s
Spreads em mais de 20 exchangesAté 40 conectores mais a unificaçãoUma requisição
Status de depósitos e saquesUm endpoint por exchange, com chave na BinanceCampos na linha da operação
DEX, on-chain, mercados de previsãoNós, indexadores, APIs das plataformasO 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.

DadosExemplo de endpointPlanos de API
Spreads CEX/arbitrage/spot-spotTodos
DEX e cross-chain/arbitrage/dex-spotPro, Max
Livros de ofertas/orderbooks/execPro, Max
Funding e OI/funding/ratesTodos
On-chain/onchain/{section}Start, Pro, Max
Mercados de previsão e surebets/predictions/arbitrageStart: 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.

PlanoChamadas por mêsRequisições por segundoAtualidade
Trial, US$ 20/mês500 K160 s
Start, US$ 502 M230 s
Pro, US$ 1005 M510 s
Max, US$ 20010 M155 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).