Fraîcheur des données
Fraîcheur des données : c'est l'âge des données au moment où elles vous parviennent, soit le nombre de secondes écoulées entre leur construction et l'arrivée de la réponse. En arbitrage, elle décide si un spread est encore vivant : une paire calculée sur des cotations vieilles d'une minute peut s'être refermée avant votre requête.
Fraîcheur selon le plan Genesis API
Le cœur de Genesis Arbitrage actualise les données chaque seconde, et votre plan Genesis API fixe la fréquence de mise à jour de la sortie de l'API. Chaque réponse contient la valeur de votre plan dans meta.freshness_sec et l'heure de construction des données dans meta.updated_at (format de réponse).
| Plan | freshness_sec | Interrogation maximale |
|---|---|---|
| Trial | 60 | une fois toutes les 60 s |
| Start | 30 | une fois toutes les 30 s |
| Pro | 10 | une fois toutes les 10 s |
| Max | 5 | une fois toutes les 5 s |
Interroger plus vite que freshness_sec renvoie le même instantané. Envoyez l'ETag de la réponse précédente dans If-None-Match : si rien n'a changé, l'API répond 304 sans corps, et cette réponse ne consomme pas de quota (ETag et If-None-Match, polling d'API). Pendant la reconstruction des données, vous recevez 503 snapshot_not_ready ; réessayez après Retry-After secondes.
Carnet d'ordres et âge par plateforme
Les carnets d'ordres ont leur propre horodatage. Dans /orderbooks/book et /orderbooks/coin/{coin}, chaque carnet contient book_ts (l'heure du carnet), age_sec (son âge en secondes) et stale, qui vaut true quand le carnet a plus de 30 s. Les carnets ont 5 à 20 secondes de retard sur l'exchange (carnet d'un marché).
age_sec est calculé à la construction de la réponse ; à la réception, now − book_ts est donc plus précis. Pour les marchés prédictifs, /predictions/platforms indique la fraîcheur par plateforme : quotes_at est l'heure de ses dernières cotations et full_scan_at celle de son dernier balayage complet.
Vérification dans le code
Les carnets d'ordres sont disponibles avec les plans Pro et Max, tandis que la vérification de meta est la même pour tous les endpoints.
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/orderbooks/book"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def get_json(params, tries=3):
for _ in range(tries):
r = requests.get(URL, headers=HEADERS, params=params,
timeout=10)
if r.status_code in (429, 503): # rate limit ou reconstruction
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
r.raise_for_status()
return r.json()
raise RuntimeError("data not ready")
params = {"exchange": "Binance", "market": "spot", "coin": "BTC"}
body = get_json(params)
now = time.time()
meta = body["meta"]
print(f"âge de l'instantané {now - meta['updated_at']:.0f} s,"
f" fraîcheur du plan {meta['freshness_sec']} s")
book = body["data"]
ts = book["book_ts"]
if book["stale"] or ts is None or now - ts > 30:
print("le carnet d'ordres est périmé, signal ignoré")
Voir aussi : limites de Genesis API, interroger une API sans atteindre les limites, risques de l'automatisation, carnet d'ordres.
Questions et réponses
En quoi la fraîcheur diffère-t-elle de la latence ?
La latence est tout le trajet entre un événement sur l'exchange et votre code : publication par l'exchange, collecte, calcul, livraison et votre intervalle d'interrogation. La fraîcheur est la partie visible dans la réponse : depuis combien de temps l'instantané a été construit. Un serveur peut répondre en une fraction de seconde et renvoyer pourtant un instantané vieux d'une minute.