Documentação da Genesis API
Tudo para integrar: autenticação, limites, endpoints e esquemas de resposta.
Planos e limites
Os limites são definidos pelo plano. O estado atual está sempre em /account/usage e nos cabeçalhos de cada resposta.
| Trial | Start | Pro | Max | |
|---|---|---|---|---|
| Chamadas por mês | 500K | 2M | 5M | 10M |
| Requisições por segundo | 1 | 2 | 5 | 15 |
| Frescor dos dados | 60 s | 30 s | 10 s | 5 s |
Endpoints fora do seu plano retornam 403 com o código plan_restricted. Requisições acima dos limites nunca são cobradas.
Apenas uma resposta 200 conta como chamada. Respostas 304 (não modificado) e erros 4xx/5xx não consomem a cota, mas contam para o limite de requisições por segundo.
O volume de download é limitado a 60 MB de dados comprimidos a cada 10 segundos por chave. Consultar todos os conjuntos de dados na frequência do seu plano cabe com folga; respostas abaixo de 64 KB não são contadas. Acima do limite — 429 download_limited até o fim da janela, sem cobrança. Economize tráfego com If-None-Match, filtros e o parâmetro coin.
Cabeçalhos de limites
| Cabeçalho | Descrição | |
|---|---|---|
X-RateLimit-Limit | Limite de requisições por segundo do seu plano | |
X-RateLimit-Remaining | Requisições restantes na janela atual | |
X-RateLimit-Reset | Tempo unix do reinício da janela | |
X-Quota-Limit | Cota de chamadas do período atual de 30 dias | |
X-Quota-Remaining | Chamadas restantes no período | |
X-Quota-Reset | Tempo unix do reinício da cota | |
Retry-After | Segundos a esperar antes de repetir (com 429 e 503) |