Início rápido da Genesis API: chave, primeira requisição e limites
Em resumo
- A Genesis API é o acesso REST aos dados da Genesis Arbitrage: spreads CEX e DEX, livros de ofertas, funding, cross-chain, fluxos on-chain, mercados de previsão e sinais do Genesis AI+.
- A primeira requisição exige três passos: um plano, uma chave no seu perfil e uma requisição GET com o cabeçalho X-API-Key.
- Seu plano define a cota de chamadas, as requisições por segundo e o atraso dos dados — de 60 segundos no Trial a 5 segundos no Max.
A Genesis API entrega os dados da Genesis Arbitrage como uma API REST: spreads entre CEX e DEX, livros de ofertas, funding, cross-chain, fluxos on-chain, mercados de previsão e sinais do Genesis AI+. Cada ferramenta do site está disponível como um endpoint próprio, com um único formato JSON. Para a primeira requisição, você precisa de um plano da API, uma chave e um cabeçalho HTTP — não é necessário SDK, qualquer linguagem com cliente HTTP serve.

O que a API cobre
Os endpoints espelham as seções do site:
- Arbitragem — Spot – Spot, Spot – Futuros, Futuros – Futuros, DEX – Spot, DEX – Futuros, Crosschain e Arbitragem de ações.
- Livros de ofertas — preços de execução para um volume em todos os mercados, «Δ do livro de ofertas» para as linhas de arbitragem, o livro de ofertas de um mercado, histórico de execução e slippage em DEX (nos planos API Pro e Max).
- Mercados de previsão — arbitragem de previsões e status das plataformas; análises, smart money, grandes negociações e ranking de traders nos planos API Pro e Max.
- Funding — taxas de funding de todas as exchanges, spread de funding e análise histórica de funding (nos planos API Pro e Max).
- Mercado — Fair – Last, CEX Pumps – Dumps, DEX Dumps, OI Tracking.
- On-chain — grandes transferências, fluxos de CEX, mint e bridges, carteiras de equipes, posições em Perp. DEX, unlocks, claims, hacks; nos planos API Pro e Max também a visão geral de DEX, análises e a página da moeda.
- IA e busca — sinais do Genesis AI+ e o perfil completo da moeda.
- Conta — o estado da sua chave: plano, cota usada e limites.
Os conjuntos de dados estão descritos na página Genesis API; os parâmetros e campos de cada endpoint estão na documentação.
Planos e limites
A API tem planos próprios, separados da assinatura do site: Trial, Start, Pro e Max. Eles se diferenciam pela cota de chamadas, pelo limite de requisições por segundo e pelo frescor dos dados.
| Plano da API | Chamadas por mês | Frescor dos dados |
|---|---|---|
| Trial | 500K | 60 s |
| Start | 2M | 30 s |
| Pro | 5M | 10 s |
| Max | 10M | 5 s |
O Trial custa US$ 20 por mês, e o Max permite 15 requisições por segundo. Endpoints que não fazem parte do seu plano retornam o erro 403 com o código plan_restricted. Requisições acima dos limites não são cobradas: aguarde o novo período ou faça upgrade. Só as respostas 200 consomem a cota: erros e respostas 304 são gratuitos. Os preços e a comparação completa estão na página Preços da Genesis API.
Sua primeira requisição
Escolha um plano
Na página Preços da Genesis API, escolha um plano e um período e clique em "Assinar". O pagamento é em cripto, igual à assinatura do site. Se outro plano da API já estiver ativo, pagar um novo o substitui e o restante é perdido — o site avisa antes.
Obtenha sua chave
No seu perfil, no bloco Genesis API, clique em "Obter chave". Uma chave
gns_live_…aparece na janela "Sua chave API" — clique em "Copiar" e guarde-a. Ela é exibida só uma vez.Faça uma requisição
Envie um HTTP GET comum e passe a chave no cabeçalho
X-API-Key. A URL base éhttps://api.genesisarbitrage.com/v1. Um bom primeiro endpoint é/account/usage— ele mostra seu plano e a cota restante.Interprete a resposta
Uma resposta bem-sucedida vem em um único envelope: um array
datae um blocometa. Se algo der errado, consulte a tabela de erros abaixo.
Um exemplo com curl:
curl "https://api.genesisarbitrage.com/v1/account/usage" \
-H "X-API-Key: gns_live_…"
A documentação tem um formulário "Testar": cole sua chave, clique em "Enviar requisição" e veja uma resposta resumida na própria página. A chave fica armazenada só no seu navegador.
Formato da resposta
datacontém um array ou um objeto, dependendo do endpoint.metacontém o número de itens, o horário da última atualização dos dados, o atraso do seu plano em segundos e o seu plano.- Valores vazios são
null. Os tempos são em segundos unix. - Spreads e taxas são porcentagens: 0.92 significa 0,92%.
- Todos os parâmetros de filtro são opcionais: sem eles, um endpoint retorna o conjunto completo de dados.
Erros e limites
| Código | Significado |
|---|---|
| 401 | A chave está ausente, é inválida ou foi revogada |
| 403 | O endpoint não faz parte do seu plano |
| 404 | O endpoint ou o recurso não foi encontrado |
| 429 | Limite de requisições excedido — veja os cabeçalhos X-RateLimit e Retry-After |
| 500 | Erro interno, tente novamente mais tarde |
| 503 | Os dados estão sendo reconstruídos, tente de novo em alguns segundos — veja Retry-After |
Os cabeçalhos X-RateLimit em cada resposta mostram o seu limite de requisições por segundo, quantas requisições restam na janela atual e quando a janela reinicia. Os cabeçalhos X-Quota mostram a cota de chamadas do período, o que resta e quando ela reinicia. Cada resposta também traz um X-Request-Id: ao contatar o suporte, envie-o junto com o horário da requisição em UTC, o endpoint e o status. Nunca envie a chave em si.
Próximos passos
- Chave API: obter, guardar, reemitir — onde a chave fica no seu perfil e como protegê-la.
- Limites: cota, requisições por segundo, frescor — como evitar respostas 429.
- Respostas e erros: JSON, ETag, códigos HTTP — o envelope de resposta, o 304 e as novas tentativas.
- Endpoints por grupo: arbitragem, livros de ofertas, funding, mercado e sinais de IA, on-chain, mercados de previsão e surebets.
- Genesis API para agentes de IA — a especificação OpenAPI, o llms.txt e o function calling.
Perguntas e respostas
Qual a diferença entre a Genesis API e as APIs gratuitas das exchanges?
As APIs das exchanges retornam os livros de ofertas e os tickers de uma única plataforma. A Genesis API retorna spreads calculados entre dezenas de exchanges e redes, flags de depósito e saque e dados limpos de pares ilíquidos.
O que acontece se eu exceder o limite?
O servidor responde com 429 e os cabeçalhos X-RateLimit e Retry-After. As requisições extras não são cobradas.
Posso trocar meu plano da API?
Sim. Um novo plano passa a valer logo após o pagamento: os novos limites e o novo frescor se aplicam imediatamente, a cota de chamadas começa do zero e o restante do plano anterior é perdido. Renovar o mesmo plano soma dias ao prazo atual.
Posso usar os dados no meu próprio produto?
Sim, você pode construir seus próprios serviços, bots e dashboards sobre a Genesis API. Não é permitido revender os dados brutos como estão.