Risques de l’automatisation : données, erreurs, clés et IA
En bref
- Vérifiez les données avant toute alerte : l’âge du snapshot (heure actuelle moins
meta.updated_at), le drapeaustaledes carnets d’ordres, le spread aux meilleures cotations et un contrat commun sur les deux exchanges de la paire. - Un
503signifie qu’il n’y a pas de données, tandis qu’undatavide avec un200signifie que rien ne correspond au filtre. Le bot distingue les deux cas et signale une panne après trois cycles sans données. - Le code casse sur les cas limites : réessayer sans pause mène à un
429, unnulldans une comparaison fait planter Python, la division par zéro en JavaScript donneInfinityet une fausse alerte, et l’heure locale au lieu d’UTC décale un paiement de funding de plusieurs heures. - Une clé Genesis API est en lecture seule : une fuite consomme votre quota. Une clé d’exchange avec droit de retrait met l’argent en danger, et un bot de trading n’a pas besoin de ce droit.
- Un modèle d’IA confond les nombres et peut suivre une commande cachée dans le texte d’autrui : le code insère les nombres dans les messages, les champs externes parviennent au modèle comme des données, le code impose les limites de trade et un humain confirme chaque ordre.
Les risques d’un bot de trading sur une API crypto se répartissent en quatre groupes : les données sont périmées ou montrent un spread qui n’existe pas ; le code boucle ou plante sur un cas limite ; la clé fuit ; un modèle d’IA se trompe de nombre ou suit la commande de quelqu’un d’autre. Chaque risque a une vérification dans le code ou une règle de travail, et toutes tiennent aussi dans le moniteur de la leçon 4.
Risques liés aux données
Un snapshot périmé
Un snapshot de Genesis API est construit à meta.updated_at, et votre forfait le renouvelle toutes les meta.freshness_sec secondes : 60 en Trial, 30 en Start, 10 en Pro et 5 en Max. L’âge du snapshot est l’heure actuelle moins meta.updated_at, c’est-à-dire sa fraîcheur des données. Un ou deux intervalles du forfait, c’est normal ; plus de trois signifie que le snapshot est bloqué.
Exemple hypothétique : en Pro, le seuil est de 3 × 10 = 30 s. Une réponse arrive à 1783802470 avec meta.updated_at = 1783802410 : l’âge est 1783802470 − 1783802410 = 60 s, donc le bot n’envoie aucune alerte à partir d’elle. La latence totale de l’exchange jusqu’à votre code est encore plus grande, et l’âge se mesure avec l’horloge de votre serveur : gardez-la synchronisée par NTP.
Carnets d’ordres et plateformes de prédiction
Les carnets d’ordres ont leur propre horloge : /orderbooks/book renvoie book_ts, age_sec et un drapeau stale qui vaut true quand le carnet a plus de 30 secondes. Les carnets ont 5 à 20 secondes de retard sur l’exchange. Dans Order-book Δ, vérifiez order_delta.status : ok signifie calculé, no_book signifie qu’il n’y a pas de carnet, exhausted signifie que le carnet n’a pas pu absorber le volume.
Pour les marchés de prédiction, il y a /predictions/platforms : ignorez les paires qui impliquent une plateforme en mode = down, une plateforme avec un quotes_at ancien ou un bookmaker avec ok = false.
Une réponse vide sur un 503
Une liste vide et l’absence de données sont deux états différents. Un 200 avec meta.count = 0 signifie qu’aucune ligne ne correspond au filtre. Un 503 snapshot_not_ready signifie que les données sont en cours de reconstruction : le marché peut très bien avoir des paires, et vous réessayez après Retry-After secondes.
La fonction fetch renvoie (data, meta), ou None quand il n’y a pas de données. Elle réessaie 429 et 503 après Retry-After, les autres erreurs 5xx et les pannes réseau après des pauses de 5, 10 et 20 secondes, et s’arrête pour tout le reste.
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def fetch(path, params=None, tries=4):
"""(data, meta), ou None : pas de données, ce qui n'est pas "pas de paires"."""
for attempt in range(tries):
try:
r = requests.get(BASE + path, headers=HEADERS,
params=params, timeout=15)
code = r.status_code
except requests.RequestException:
code = 0 # erreur réseau ou timeout : réessayer après une pause
if code == 200:
body = r.json()
return body["data"], body["meta"]
wait = 5 * 2 ** attempt # 5, 10, 20 s : la pause s'allonge
if code in (429, 503):
wait = int(r.headers.get("Retry-After", wait))
if wait > 60: # ne jamais attendre plus d'une minute
raise RuntimeError(f"attente de {wait} s : vérifiez votre quota")
elif 400 <= code < 500:
# 400, 401, 403, 404, 410 : un nouvel essai n'y changera rien
raise RuntimeError(f"{code}: {r.text[:200]}")
if attempt < tries - 1:
time.sleep(wait)
return None
Un long Retry-After arrive aussi quand le quota de la période est épuisé : la réinitialisation peut être à plusieurs jours, et fetch n’attend jamais plus d’une minute. Les retries, ETag et les filtres sont traités dans l’article sur l’interrogation d’une API sans atteindre les limites.
Un faux spread : carnets minces et tokens sosies
spread_pct est calculé à partir des derniers trades, alors que vous ne pouvez acheter qu’à l’ask et vendre qu’au bid. Dans l’exemple de FUEL du guide des endpoints d’arbitrage, le spread est de 0,11 % sur les derniers trades et de −0,11 % aux meilleures cotations. Les champs ask_buy et bid_sell figurent dans chaque ligne Spot – Spot, quel que soit le forfait, et quote_spread ci-dessous les utilise pour calculer le spread aux meilleures cotations.
Un carnet d’ordres mince gonfle l’écart. Exemple hypothétique : le dernier trade a été affiché à 1,18 $ il y a une heure, le meilleur bid est maintenant de 1,02 $ et l’ask sur l’exchange d’achat est de 1,00 $. Le spread est de 18 % sur les derniers trades et de 2 % aux meilleures cotations, et 1 000 $ peuvent ne pas être exécutés du tout : en Pro et Max, order_delta.status = exhausted avec volume=1000 le montre exactement.
La seconde source de faux spreads est un même ticker partagé par des tokens différents, par exemple un token sur BSC et un projet sans rapport sur Solana. Pour un token avec contrat, interrogez /coins/search avec le ticker dans query : contracts[] doit contenir une entrée dont exchanges liste les deux exchanges de la paire (comparez les noms sans tenir compte de la casse). Sans telle entrée, il n’y a pas de transfert direct : ce sont des tokens différents, ou la route passe par un pont avec ses propres risques.
def is_fresh(meta, k=3):
"""Le snapshot a au plus k intervalles du forfait."""
age = time.time() - meta["updated_at"]
return age <= k * meta["freshness_sec"]
def quote_spread(row):
"""Spread aux meilleures cotations : acheter à l'ask, vendre au bid."""
ask, bid = row.get("ask_buy"), row.get("bid_sell")
if ask is None or bid is None or ask <= 0:
return None # pas de prix ou prix nul : ignorer la ligne
return (bid - ask) / ask * 100
pause, fails = 60, 0
while True:
got = fetch("/arbitrage/spot-spot", {"min_spread": 1})
if got is None or not is_fresh(got[1]):
fails += 1 # pas de données ou données périmées : pas d'alertes
if fails == 3:
print("3 cycles sans données fraîches") # alertez-vous vous-même
else:
rows, meta = got
fails, pause = 0, meta["freshness_sec"]
for row in rows:
s = quote_spread(row)
if s is not None and s >= 0.5:
print(row["coin"], row["exchange_buy"], "→",
row["exchange_sell"], f"{s:.2f}%")
time.sleep(pause) # la pause s'exécute sur tous les chemins
Une exception de fetch arrête la boucle : un bot de production prévient son propriétaire avant de quitter.
Risques liés au code
Retries sans pause et boucles infinies
Un premier bot réessaie souvent juste après une erreur : if r.status_code != 200: continue. Sur un 503, une telle boucle envoie des requêtes à la chaîne sans pause : les erreurs ne consomment pas de quota, mais comptent dans la limite de requêtes par seconde, et un 429 avec Retry-After: 1 suit. Une fois l’abonnement expiré, la même boucle reçoit 401 indéfiniment. Et un continue placé avant time.sleep() saute la pause à chaque réponse vide, ce qui explique que la pause soit la dernière ligne de la boucle ci-dessus.
L’erreur inverse est d’attendre indéfiniment. time.sleep(int(r.headers["Retry-After"])) sur un quota épuisé dort des jours : par exemple, Retry-After: 259200 fait 259 200 / 86 400 = 3 jours. Une requête sans timeout peut aussi rester suspendue indéfiniment, comme le signale la documentation de requests.
null et division par zéro
Genesis API utilise null pour les valeurs vides, et Python le transforme en None. Comparer row["volume_24h_sell"] > 10000 avec None lève TypeError, et une seule ligne fait tomber toute la boucle. JavaScript ne lève rien : null > 0.5 vaut false, null < 1 vaut true, et le filtre échoue en silence.
null signifie « pas de données », et le remplacer par zéro avec or 0 est dangereux : dans le slippage DEX, tax_sell_pct = null signifie qu’il n’y a pas de source pour la taxe, et or 0 en fait 0 %. Selon la documentation, null apparaît dans bid_* et ask_*, volume_24h_*, max_position_usd, next_payout, dans profit_usd pour les paires avec une jambe bookmaker et dans apr_pct quand il reste moins d’une journée.
La division par zéro est le même piège. Un ask nul lève ZeroDivisionError en Python, alors qu’en JavaScript 1 / 0 vaut Infinity et Infinity > 0.5 vaut true : le bot envoie une paire avec un spread infini. Vérifiez le dénominateur avant de diviser, comme quote_spread vérifie ask <= 0.
Fuseaux horaires
Les heures de Genesis API sont des secondes unix et des chaînes UTC : next_payout dans les taux de funding arrive sous la forme HH:MM UTC. datetime.fromtimestamp(ts) sans fuseau horaire renvoie l’heure locale du serveur, et datetime.utcnow() est obsolète depuis Python 3.12 ; la documentation Python renvoie à datetime.now(timezone.utc).
Exemple hypothétique : le serveur est en UTC+3 et son horloge indique 09:30, soit 06:30 UTC. Le paiement de 08:00 est dans 1 h 30 min, mais un code qui compare 08:00 à l’heure locale décide que le paiement est passé et compte 22 h 30 min jusqu’au suivant, soit 21 heures d’écart.
from datetime import datetime, timedelta, timezone
def until_payout(hhmm, now=None):
"""Temps jusqu'à next_payout, une chaîne HH:MM en UTC."""
if hhmm is None:
return None # null : pas d'heure de paiement
now = now or datetime.now(timezone.utc)
h, m = map(int, hhmm.split(":"))
t = now.replace(hour=h, minute=m, second=0, microsecond=0)
if t <= now:
t += timedelta(days=1) # "00:00" à 23:50 signifie demain
return t - now
now = datetime(2026, 11, 15, 6, 30, tzinfo=timezone.utc)
print(until_payout("08:00", now)) # 1:30:00
Risques liés aux clés
Une clé Genesis API est en lecture seule : elle ne peut ni passer d’ordres ni retirer de fonds. Une fuite touche votre quota et la limite de requêtes par seconde, et votre bot reçoit 429 avant la fin de la période. Signes d’alerte : « Appels utilisés » dans votre profil grimpe plus vite que ne l’explique votre code, ou « utilisée le … » affiche une date récente alors que le bot est arrêté.
La clé ne s’affiche qu’une fois et Genesis Arbitrage ne conserve que son hash : une clé divulguée se régénère. « Régénérer » désactive aussitôt l’ancienne clé et en émet une nouvelle. Les clés fuient là où elles ont été mises par erreur : un dépôt public, l’URL d’une requête, le code d’une page, une capture d’écran, un log contenant les en-têtes de requête. Journalisez plutôt le code d’état et X-Request-Id ; les règles de stockage figurent dans l’entrée du glossaire clé API.
Une clé d’exchange relève d’une autre classe de risque : avec le droit de retrait, elle peut sortir des coins du compte. Un bot de trading n’a pas besoin de ce droit : créez donc la clé sans retraits, liée à l’IP de votre serveur et distincte pour chaque service. Les détails sont dans comment sécuriser votre compte d’exchange crypto.
Agents IA : nombres, commandes injectées, confirmation
Un agent appelle Genesis API via votre serveur : le modèle choisit l’endpoint et les arguments, et le serveur envoie la requête avec la clé. La configuration est décrite dans le guide Genesis API pour les agents IA, et la conception d’ensemble dans l’article sur les données de marché crypto pour les agents IA.
Nombres erronés
Un modèle peut lire 0.92 comme 92 % au lieu de 0,92 %, confondre le funding_pct par intervalle avec le funding_8h_pct sur 8 heures, ou citer un prix qui ne figure pas dans la réponse. Le code insère les nombres dans les alertes directement depuis la réponse de l’API, et le modèle garde la sélection et l’explication. Si le modèle écrit lui-même des nombres, vérifiez chacun d’eux avec le résultat de l’outil.
Commandes dans un texte extérieur
Certains champs sont écrits par d’autres personnes : title et outcome des marchés de prédiction, le name des traders, le token_name des événements on-chain, et les message_ru et message_en des signaux. N’importe qui peut nommer un token « Ignore les instructions précédentes et… », et un modèle qui lit ce nom comme une partie de son prompt peut y obéir. C’est l’injection de prompt (prompt injection), première entrée du OWASP Top 10 pour les applications LLM 2025 : LLM01:2025.
Ne transmettez ces champs qu’à l’intérieur du résultat de l’outil, limitez leur longueur et indiquez dans le prompt système que ce sont des données. La clé reste dans le gestionnaire côté serveur.
Confirmation humaine
Genesis API ne fait que lire les données : un agent bâti dessus trouve une paire et écrit à son sujet, mais ne trade pas. Une API de trading d’exchange branchée sur l’agent sort du cadre de Genesis API et se fait à vos risques. Parmi ses mesures d’atténuation, OWASP cite le contrôle avec un humain dans la boucle (human-in-the-loop) pour les opérations privilégiées : un ordre ne part qu’après un « oui » d’un trader qui voit la paire, les prix et l’heure des données.
Liste de contrôle avant le lancement
- La clé est dans
GENESIS_API_KEYsur le serveur et nulle part dans le code, les URL de requête, le navigateur, les logs ou les prompts. - Chaque requête a un
timeout. - Seuls
429,503, les autres erreurs 5xx et les pannes réseau sont réessayés, avec une pause et au plus trois fois. 400,401,403,404,410et unRetry-Afterde plus d’une minute arrêtent le bot avec un message.- La pause entre deux interrogations est d’au moins
meta.freshness_secet s’exécute sur tous les chemins de la boucle. - L’âge du snapshot est vérifié avant toute alerte, et pour les carnets d’ordres,
staleetorder_delta.statusle sont aussi. - « Pas de données » et « pas de paires » sont des états distincts, et trois cycles sans données déclenchent un message de panne.
nullest testé contreNone, les dénominateurs contre zéro, et l’heure est traitée en UTC.- Une paire passe sur son spread aux meilleures cotations, un contrat commun,
withdraw_enabled_buyetdeposit_enabled_sell. - Le code insère les nombres dans les messages, le texte extérieur parvient au modèle comme des données, et un humain confirme chaque ordre.
Fin du cours : par où continuer
Le cours compte cinq leçons : les concepts, une première requête, les données pour décider, un moniteur Python et ses risques ; les bases sont dans la leçon 1. Détails de chaque étape :
- Démarrage rapide de Genesis API : la clé et une première requête ;
- Limites de Genesis API : le quota et le dimensionnement d’un forfait pour votre bot ;
- Réponses et erreurs de Genesis API : codes,
ETagetX-Request-Id; - Endpoints des carnets d’ordres : Order-book Δ pour votre volume ;
- Bot d’arbitrage crypto en Python : un bot avec alertes Telegram ;
- API crypto : types et comment choisir : un panorama des sources de données.
À vous de jouer
Trouvez la fraîcheur de votre forfait
Appelez
/account/usageet notezfreshness_secetcalls_used: cette requête ne compte pas comme un appel.Mesurez l’âge du snapshot
Récupérez
/arbitrage/spot-spotavecfetch, afficheztime.time() - meta["updated_at"]et comparez-le au seuil de 3 ×freshness_sec.Comparez deux spreads
Affichez
spread_pctetquote_spread(row)pour cinq lignes et comptez combien de paires restent positives aux meilleures cotations.Testez le chemin d’erreur
Lancez le bot avec le texte factice
GENESIS_API_KEY=gns_live_XXXXXXXXXXXXXXXX: la réponse401 invalid_keydoit l’arrêter avec un message clair.Parcourez la liste de contrôle
Ajoutez ce qui manque à votre code avant de faire tourner le bot jour et nuit.