Genesis Arbitrage

Genesis Arbitrage · · 3 min de lecture

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 quotaIntervalle = fraîcheurAppels par endpointEndpoints dans le quota
Trial, 500K60 s43 20011
Start, 2M30 s86 40023
Pro, 5M10 s259 20019
Max, 10M5 s518 40019

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éthodeQui lance le transfertAdapté à
PollingLe client, selon un calendrierDes données mises à jour à un pas connu ; tout client HTTP convient
WebSocketLe serveur, via une connexion ouverteUn flux continu de changements : carnets d’ordres et transactions d’un exchange
WebhookLe serveur, par une requête vers votre URLDes é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.