Genesis Arbitrage

Genesis Arbitrage · · 3 min de lecture

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 :

ForfaitRequêtes par secondeAppels sur 30 joursDurée du quota à plein débit
Trial1500K5,8 jours
Start22M11,6 jours
Pro55M11,6 jours
Max1510M7,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êteCe qu’il indique
X-RateLimit-LimitLimite de requêtes par seconde de votre forfait
X-RateLimit-RemainingRequêtes restantes dans la fenêtre en cours
X-RateLimit-ResetHeure unix de réinitialisation de la fenêtre
Retry-AfterSecondes à 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.