Genesis Arbitrage

Genesis Arbitrage · · Atualizado · 6 min de leitura

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.

Início rápido da Genesis API: chave, primeira requisição e limites
Como fica no Genesis Arbitrage

O que a API cobre

Os endpoints espelham as seções do site:

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 APIChamadas por mêsFrescor dos dados
Trial500K60 s
Start2M30 s
Pro5M10 s
Max10M5 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

  1. 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.

  2. 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.

  3. 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.

  4. Interprete a resposta

    Uma resposta bem-sucedida vem em um único envelope: um array data e um bloco meta. 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

Erros e limites

CódigoSignificado
401A chave está ausente, é inválida ou foi revogada
403O endpoint não faz parte do seu plano
404O endpoint ou o recurso não foi encontrado
429Limite de requisições excedido — veja os cabeçalhos X-RateLimit e Retry-After
500Erro interno, tente novamente mais tarde
503Os 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

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.