HTTP 429 Too Many Requests
HTTP 429 Too Many Requests est le code d’état qu’un serveur renvoie lorsqu’un client a envoyé trop de requêtes en un temps donné et a atteint le rate limit. Le code a été introduit par la RFC 6585 en 2012. Le standard ne précise pas comment les requêtes sont comptées (par clé, adresse IP ou ressource, par seconde ou par heure) : chaque service fixe ses propres règles.
Comment gérer un 429
Cette fonction interroge le spread de funding et réessaie après les réponses 429 et 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 pause du serveur si elle est donnée, sinon 1, 2, 4… secondes
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))
Doubler la pause s’appelle le backoff exponentiel. Une nouvelle tentative sans pause recevra très probablement un autre 429. Si plusieurs copies d’un bot envoient des requêtes, ajoutez à chaque pause une fraction de seconde aléatoire pour que leurs nouvelles tentatives n’arrivent pas au même instant.
Le 429 dans Genesis API
Genesis API renvoie 429 avec l’un de deux codes dans le corps de la réponse, plus un en-tête Retry-After :
| Code | Quand | Que faire |
|---|---|---|
rate_limited | Limite de requêtes par seconde dépassée : de 1 en Trial à 15 en Max | Attendre Retry-After, étaler les requêtes dans le temps |
download_limited | Plus de 60 Mo de données compressées par 10 secondes et par clé | Attendre la fin de la fenêtre, restreindre la requête avec des filtres et coin |
{
"success": false,
"error": {
"code": "rate_limited",
"message": "Requests per second limit exceeded."
}
}
Les requêtes au-delà des limites ne sont jamais facturées : seule une réponse 200 compte comme un appel, et un 429, comme toute autre erreur, ne consomme pas votre quota. Les erreurs comptent toutefois dans la limite de requêtes par seconde : des tentatives rapprochées déclenchent donc de nouveaux 429. L’en-tête X-RateLimit-Remaining indique ce qu’il reste dans la fenêtre en cours et X-Quota-Remaining, le quota restant.
Voir aussi : API polling, ETag et If-None-Match, erreurs dans la documentation de Genesis API, limites de Genesis API.
Questions et réponses
En quoi le 429 diffère-t-il du 503 ?
429 signifie que vous interrogez trop souvent. Dans Genesis API, 503 avec le code snapshot_not_ready signifie que les données sont en cours de reconstruction ou que leur source redémarre : réessayez après Retry-After secondes.
Pourquoi ai-je un 429 alors que mon bot envoie peu de requêtes ?
La limite s’applique par clé : deux scripts qui partagent une clé partagent la limite. Autre cause : des téléchargements complets fréquents sans filtres, qui se heurtent au plafond de volume download_limited.