Genesis Arbitrage

Genesis Arbitrage · · 3 min de leitura

HTTP 429 Too Many Requests

HTTP 429 Too Many Requests é o código de status que um servidor devolve quando um cliente enviou requisições demais em um dado intervalo e atingiu o rate limit. O código foi introduzido na RFC 6585 em 2012. O padrão não define como as requisições são contadas (por chave, endereço IP ou recurso, por segundo ou por hora), então cada serviço define suas próprias regras.

Como tratar um 429

Esta função consulta o spread de funding e tenta de novo após respostas 429 e 503:

import os
import time
import requests

URL = "https://api.genesisarbitrage.com/v1/funding/spread"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}

def get_with_retry(params, attempts=5):
    delay = 1
    for _ in range(attempts):
        r = requests.get(URL, headers=HEADERS,
                         params=params, timeout=10)
        if r.status_code not in (429, 503):
            r.raise_for_status()
            return r.json()["data"]
        wait = r.headers.get("Retry-After", "")
        # a pausa do servidor, se houver; senão 1, 2, 4… segundos
        time.sleep(int(wait) if wait.isdigit() else delay)
        delay = min(delay * 2, 60)
    raise RuntimeError("still rate limited: poll less often")

rows = get_with_retry({"min_spread": 0.05})
print("coins with a funding spread of 0.05% or more:", len(rows))

Dobrar a pausa chama-se backoff exponencial. Uma nova tentativa sem pausa quase certamente recebe outro 429. Se várias cópias de um bot enviam requisições, some a cada pausa uma fração aleatória de segundo para que as tentativas não cheguem ao mesmo tempo.

O 429 na Genesis API

A Genesis API devolve 429 com um de dois códigos no corpo da resposta, mais o cabeçalho Retry-After:

CódigoQuandoO que fazer
rate_limitedLimite de requisições por segundo excedido: de 1 no Trial a 15 no MaxEsperar o Retry-After e distribuir as requisições no tempo
download_limitedMais de 60 MB de dados comprimidos por 10 segundos por chaveEsperar o fim da janela e restringir a consulta com filtros e coin
{
  "success": false,
  "error": {
    "code": "rate_limited",
    "message": "Requests per second limit exceeded."
  }
}

Requisições acima dos limites nunca são cobradas: só uma resposta 200 conta como chamada, e um 429, como qualquer outro erro, não consome sua cota. Os erros, porém, contam para o limite de requisições por segundo, então repetições rápidas geram novos 429. O cabeçalho X-RateLimit-Remaining mostra o que resta na janela atual e X-Quota-Remaining, a cota restante.

Veja também: API polling, ETag e If-None-Match, erros na documentação da Genesis API, limites da Genesis API.

Perguntas e respostas

Qual a diferença entre 429 e 503?

429 significa que você pergunta com frequência demais. Na Genesis API, 503 com o código snapshot_not_ready significa que os dados estão sendo reconstruídos ou que a fonte deles está reiniciando: tente de novo após Retry-After segundos.

Por que recebo 429 se meu bot envia poucas requisições?

O limite é por chave, então dois scripts que usam a mesma chave dividem o limite. Outra causa são downloads completos frequentes, sem filtros, que esbarram no teto de volume download_limited.