API polling
Le polling d’API consiste à obtenir des données récentes par des requêtes répétées selon un calendrier : toutes les N secondes, le client demande au serveur ce qui a changé. Les bots et les tableaux de bord fonctionnent ainsi avec une API REST, qui n’envoie jamais rien d’elle-même : chaque interrogation est un simple HTTP GET.
Intervalle et fraîcheur des données
Interroger plus vite que la mise à jour des données n’apporte rien : le serveur renvoie le même instantané. Dans Genesis API, la fraîcheur des données dépend du plan : la sortie est actualisée toutes les 60 secondes en Trial, 30 en Start, 10 en Pro et 5 en Max, et cette valeur arrive dans le champ meta.freshness_sec. L’heure de construction de l’instantané se trouve dans meta.updated_at ; la même valeur dans deux réponses consécutives signifie que la seconde requête était inutile.
Exemple hypothétique : en Trial, un bot interroge un endpoint toutes les 10 secondes. Sur les six requêtes par minute, une seule apporte des données nouvelles ; les cinq autres répètent l’instantané et consomment quand même du quota, sauf si le bot envoie If-None-Match.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
while True:
r = requests.get(URL, headers=HEADERS,
params={"min_spread": 1}, timeout=10)
if r.status_code in (429, 503):
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
meta = r.json()["meta"]
print("pairs:", meta["count"], "snapshot:", meta["updated_at"])
# interroger plus vite que le pas d’actualisation du plan est inutile
time.sleep(meta["freshness_sec"])
Combien d’appels consomme le polling
Interroger un endpoint toutes les 10 secondes : 2 592 000 ÷ 10 = 259 200 appels sur 30 jours. Le quota de Genesis API couvre lui aussi 30 jours.
| Plan et quota | Intervalle = fraîcheur | Appels par endpoint | Endpoints dans le quota |
|---|---|---|---|
| Trial, 500K | 60 s | 43 200 | 11 |
| Start, 2M | 30 s | 86 400 | 23 |
| Pro, 5M | 10 s | 259 200 | 19 |
| Max, 10M | 5 s | 518 400 | 19 |
Ce calcul ignore les réponses 304. En Pro, 19 endpoints toutes les 10 secondes représentent en moyenne 1,9 requête par seconde pour une limite de 5. Étalez les requêtes : 19 requêtes d’un coup dépasseraient la limite et le serveur répondrait par un HTTP 429.
Polling, WebSocket et webhooks
| Méthode | Qui lance le transfert | Adapté à |
|---|---|---|
| Polling | Le client, selon un calendrier | Des données mises à jour à un pas connu ; tout client HTTP convient |
| WebSocket | Le serveur, via une connexion ouverte | Un flux continu de changements : carnets d’ordres et transactions d’un exchange |
| Webhook | Le serveur, par une requête vers votre URL | Des événements rares, si vous avez un endpoint HTTPS public |
Genesis API n’a ni WebSocket ni webhooks : les données sont servies en REST et le plan fixe la fraîcheur. Interroger à meta.freshness_sec est la manière standard de travailler avec elle ; les moyens de réduire le trafic et les appels sont décrits dans Comment interroger une API sans atteindre les limites.
Voir aussi : rate limit, plans et limites dans la documentation, format de réponse, limites de Genesis API.
Questions et réponses
À quelle fréquence interroger Genesis API ?
Au plus aussi souvent que le meta.freshness_sec de votre plan : toutes les 60 secondes en Trial, 30 en Start, 10 en Pro et 5 en Max. Interroger plus vite renvoie les mêmes données.