HTTP 429 Too Many Requests
HTTP 429 Too Many Requests es el código de estado que devuelve un servidor cuando un cliente ha enviado demasiadas peticiones en un lapso dado y ha alcanzado el rate limit. El código se introdujo en el RFC 6585 en 2012. El estándar no define cómo se cuentan las peticiones (por clave, dirección IP o recurso, por segundo o por hora), así que cada servicio fija sus propias reglas.
Cómo gestionar un 429
Esta función consulta el spread de funding y reintenta tras respuestas 429 y 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", "")
# la pausa del servidor si existe; si no, 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))
Duplicar la pausa se llama backoff exponencial. Un reintento sin pausa casi seguro recibirá otro 429. Si varias copias de un bot envían peticiones, añade a cada pausa una fracción aleatoria de segundo para que sus reintentos no coincidan en el mismo instante.
El 429 en Genesis API
Genesis API devuelve 429 con uno de dos códigos en el cuerpo de la respuesta, más el encabezado Retry-After:
| Código | Cuándo | Qué hacer |
|---|---|---|
rate_limited | Se supera el límite de peticiones por segundo: de 1 en Trial a 15 en Max | Espera Retry-After y reparte las peticiones en el tiempo |
download_limited | Más de 60 MB de datos comprimidos por 10 segundos y por clave | Espera a que termine la ventana y acota la consulta con filtros y coin |
{
"success": false,
"error": {
"code": "rate_limited",
"message": "Requests per second limit exceeded."
}
}
Las peticiones por encima de los límites nunca se cobran: solo una respuesta 200 cuenta como llamada, y un 429, como cualquier otro error, no consume tu cuota. Eso sí, los errores cuentan para el límite de peticiones por segundo, de modo que los reintentos rápidos provocan nuevos 429. El encabezado X-RateLimit-Remaining muestra lo que queda en la ventana actual y X-Quota-Remaining, la cuota restante.
Véase también: API polling, ETag e If-None-Match, errores en la documentación de Genesis API, límites de Genesis API.
Preguntas y respuestas
¿En qué se diferencia el 429 del 503?
429 significa que preguntas demasiado a menudo. En Genesis API, 503 con el código snapshot_not_ready significa que los datos se están reconstruyendo o que su fuente se está reiniciando: reintenta pasados Retry-After segundos.
¿Por qué recibo 429 si mi bot envía pocas peticiones?
El límite es por clave, así que dos scripts que comparten una clave comparten el límite. Otra causa son las descargas completas frecuentes sin filtros, que chocan con el tope de volumen download_limited.