Rate limit
Un rate limit plafonne le nombre de requêtes qu’un client peut envoyer à une API par unité de temps. Au-delà de la limite, le serveur répond 429 Too Many Requests, défini dans la RFC 6585, et peut ajouter un en-tête Retry-After indiquant combien de secondes attendre (erreur HTTP 429).
Débit et quota
Il y a en général deux limites : le débit (requêtes par seconde ou par minute) et le quota (appels par jour ou par mois). Dans Genesis API, les deux dépendent du forfait :
| Forfait | Requêtes par seconde | Appels sur 30 jours | Durée du quota à plein débit |
|---|---|---|---|
| Trial | 1 | 500K | 5,8 jours |
| Start | 2 | 2M | 11,6 jours |
| Pro | 5 | 5M | 11,6 jours |
| Max | 15 | 10M | 7,7 jours |
La dernière colonne suppose des requêtes sans interruption à la limite de débit et un 200 pour chaque réponse. Pour Pro : 5 × 86 400 = 432 000 requêtes par jour, et 5 000 000 / 432 000 ≈ 11,6 jours. La limite par seconde est un plafond pour les rafales, tandis que le quota fixe le rythme moyen : 30 jours comptent 2 592 000 secondes, donc Pro tient en moyenne 5 000 000 / 2 592 000 ≈ 1,93 requête par seconde.
Seules les réponses 200 consomment le quota ; les 304 et les erreurs non, mais elles comptent quand même dans la limite de requêtes par seconde. Le volume de téléchargement est plafonné à part : 60 Mo de données compressées par 10 secondes et par clé ; au-delà, la réponse est 429 download_limited.
Rester dans la limite
Chaque réponse de Genesis API indique l’état de la limite dans des en-têtes :
| En-tête | Ce qu’il indique |
|---|---|
X-RateLimit-Limit | Limite de requêtes par seconde de votre forfait |
X-RateLimit-Remaining | Requêtes restantes dans la fenêtre en cours |
X-RateLimit-Reset | Heure unix de réinitialisation de la fenêtre |
Retry-After | Secondes à attendre avant de réessayer (sur 429 et 503) |
Le quota apparaît dans X-Quota-Limit, X-Quota-Remaining, X-Quota-Reset et dans l’endpoint Utilisation, /account/usage. Le code ci-dessous interroge trois endpoints à la suite : quand la fenêtre n’a plus de requêtes, il attend de lui-même X-RateLimit-Reset, et sur 429 et 503 il fait une pause 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):
# le serveur demande une pause ; le passage suivant réessaie
time.sleep(int(r.headers.get("Retry-After", "1")))
continue
r.raise_for_status()
print(path, "lignes :", r.json()["meta"]["count"])
if r.headers.get("X-RateLimit-Remaining") == "0":
# fenêtre épuisée : attendre sa réinitialisation plutôt que recevoir un 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) # fraîcheur de Pro : interroger plus vite n’apporte rien
Voir aussi : polling d’API, fraîcheur des données, Plans et limites, limites de Genesis API, comment interroger une API sans atteindre les limites.
Questions et réponses
Que se passe-t-il quand le quota mensuel est épuisé ?
Les requêtes au-delà du quota ne sont jamais facturées. Attendez la réinitialisation (l’heure est dans X-Quota-Reset) ou passez à un forfait supérieur : le nouveau forfait prend effet aussitôt, le quota repart de zéro et ce qu’il restait de l’ancien forfait est perdu.
Peut-on contourner la limite avec une seconde clé ?
Non. Un compte a une seule clé, et utiliser plusieurs comptes ou changer d’IP pour dépasser la limite enfreint les règles. Si vous manquez d’appels, supprimez les appels inutiles avec des filtres, le paramètre coin et un ETag avec If-None-Match, ou passez à un forfait supérieur.