Latence
La latence est le temps qui sépare un événement sur le marché du moment où les données le concernant arrivent dans votre code. Exemple hypothétique : une transaction s’affiche sur un exchange à 12:00:00 et votre script reçoit le nouveau prix à 12:00:12, soit une latence de 12 secondes.
De quoi se compose la latence
| Étape | Ce qui ajoute du temps |
|---|---|
| Exchange | Publication d’une transaction ou d’un changement de carnet dans son API |
| Collecte | Réception des données par WebSocket ou REST, reconnexions |
| Calcul | Rapprochement des exchanges, recalcul des spreads et des carnets |
| Livraison | Le pas d’actualisation de la sortie du plan et le réseau jusqu’à votre serveur |
| Votre code | L’intervalle de polling et le traitement de la réponse |
Certaines de ces étapes apparaissent dans les champs de réponse de Genesis API. meta.updated_at est l’heure de construction de l’instantané, et meta.freshness_sec le retard de sortie de votre plan : 60, 30, 10 ou 5 secondes. Les carnets d’ordres ont leurs propres indicateurs : age_sec est l’âge du carnet et stale signale un carnet de plus de 30 secondes ; les carnets ont 5 à 20 secondes de retard sur l’exchange (carnet d’un marché dans la documentation).
Prix périmés en arbitrage
Exemple hypothétique : un instantané pris il y a 15 secondes affiche un coin à 10,00 $ sur l’exchange A et à 10,12 $ sur l’exchange B.
| Moment | Prix sur A | Prix sur B | Spread |
|---|---|---|---|
| Dans l’instantané | 10,00 $ | 10,12 $ | 1,2 % |
| Sur l’exchange maintenant | 10,00 $ | 10,03 $ | 0,3 % |
Deux transactions avec des frais de taker de 0,1 % chacune en prélèvent 0,2 % : au lieu des 1,2 % de l’instantané, il ne reste que 0,1 %. Plus la latence est élevée, plus souvent un bot voit un spread qui a déjà disparu de l’exchange.
Temps de réponse et fraîcheur des données
Le temps de réponse du serveur et la fraîcheur des données, c’est-à-dire l’ancienneté de la construction de l’instantané, sont deux nombres différents. Exemple hypothétique : la réponse arrive en 0,2 seconde, mais l’instantané qu’elle contient a 9 secondes. Vous pouvez mesurer les deux :
import os
import time
import requests
r = requests.get(
"https://api.genesisarbitrage.com/v1/arbitrage/spot-spot",
headers={"X-API-Key": os.environ["GENESIS_API_KEY"]},
params={"coin": "BTC"},
timeout=10,
)
r.raise_for_status()
meta = r.json()["meta"]
# temps de réponse : de l’envoi de la requête à l’analyse des en-têtes
print("response time:", round(r.elapsed.total_seconds(), 2), "s")
# âge des données : temps écoulé depuis la construction de l’instantané
print("data age:", round(time.time() - meta["updated_at"]), "s")
L’âge des données est calculé d’après l’horloge de votre serveur : si l’horloge dérive, l’erreur passe dans le résultat ; gardez donc l’heure synchronisée (NTP).
Voir aussi : API polling, WebSocket, format de réponse, risques de l’automatisation : données périmées, erreurs, clés.
Questions et réponses
Quelle est la latence de Genesis API ?
La sortie est actualisée toutes les 60 secondes en Trial, 30 en Start, 10 en Pro et 5 en Max ; la valeur exacte pour votre clé arrive dans meta.freshness_sec. Votre intervalle de polling et le réseau s’y ajoutent.