Rate limit
Um rate limit limita quantas requisições um cliente pode enviar a uma API por unidade de tempo. Ao passar do limite, o servidor responde com 429 Too Many Requests, definido na RFC 6585, e pode incluir um cabeçalho Retry-After informando quantos segundos esperar (erro HTTP 429).
Taxa e cota
Em geral há dois limites: a taxa (requisições por segundo ou por minuto) e a cota (chamadas por dia ou por mês). Na Genesis API, ambos dependem do plano:
| Plano | Requisições por segundo | Chamadas em 30 dias | A cota na taxa máxima dura |
|---|---|---|---|
| Trial | 1 | 500K | 5,8 dias |
| Start | 2 | 2M | 11,6 dias |
| Pro | 5 | 5M | 11,6 dias |
| Max | 15 | 10M | 7,7 dias |
A última coluna supõe requisições ininterruptas no limite de taxa e um 200 em cada resposta. Para o Pro: 5 × 86.400 = 432.000 requisições por dia, e 5.000.000 / 432.000 ≈ 11,6 dias. O limite por segundo é um teto para picos, enquanto a cota define o ritmo médio: 30 dias têm 2.592.000 segundos, então o Pro sustenta em média 5.000.000 / 2.592.000 ≈ 1,93 requisição por segundo.
Só as respostas 200 consomem a cota; as 304 e os erros não, mas ainda contam para o limite de requisições por segundo. O volume de download tem um teto à parte de 60 MB de dados comprimidos a cada 10 segundos por chave; o que passar do teto recebe 429 download_limited.
Como ficar dentro do limite
Toda resposta da Genesis API informa o estado do limite em cabeçalhos:
| Cabeçalho | O que mostra |
|---|---|
X-RateLimit-Limit | Limite de requisições por segundo do seu plano |
X-RateLimit-Remaining | Requisições restantes na janela atual |
X-RateLimit-Reset | Horário unix em que a janela reinicia |
Retry-After | Segundos a esperar antes de tentar de novo (em 429 e 503) |
A cota aparece em X-Quota-Limit, X-Quota-Remaining, X-Quota-Reset e no endpoint Uso, /account/usage. O código abaixo consulta três endpoints em sequência: quando a janela fica sem requisições, ele espera X-RateLimit-Reset por conta própria, e em 429 e 503 faz uma pausa de Retry-After.
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PATHS = ("/arbitrage/spot-spot", "/funding/spread",
"/market/open-interest")
def poll_once():
for path in PATHS:
r = requests.get(BASE + path, headers=HEADERS, timeout=10)
if r.status_code in (429, 503):
# o servidor pede uma pausa; a próxima passada tenta de novo
time.sleep(int(r.headers.get("Retry-After", "1")))
continue
r.raise_for_status()
print(path, "linhas:", r.json()["meta"]["count"])
if r.headers.get("X-RateLimit-Remaining") == "0":
# janela esgotada: esperar o reinício em vez de receber um 429
reset = int(r.headers.get("X-RateLimit-Reset", "0"))
time.sleep(max(0.0, reset - time.time()))
while True:
poll_once()
time.sleep(10) # atualização do Pro: consultar mais rápido não adianta
Veja também: polling de API, atualidade dos dados, Planos e limites, limites da Genesis API, como fazer polling em uma API sem bater nos limites.
Perguntas e respostas
O que acontece quando a cota mensal acaba?
Requisições além da cota nunca são cobradas. Espere o reinício (o horário está em X-Quota-Reset) ou passe para um plano superior: o novo plano vale na hora, a cota começa do zero e o que sobrou do plano antigo é perdido.
Posso contornar o limite com uma segunda chave?
Não. A conta tem uma única chave, e usar várias contas ou trocar de IP para passar do limite viola as regras. Se faltarem chamadas, corte as desnecessárias com filtros, o parâmetro coin e um ETag com If-None-Match, ou passe para um plano superior.