Qu’est-ce qu’une API crypto et que peut-on automatiser
En bref
- Une API crypto est une interface de programmation par laquelle votre programme demande des données de marché et reçoit une réponse JSON : le même spread que dans un tableau du site, livré dans les champs
exchange_buy,exchange_selletspread_pct. - L’API d’un exchange couvre les données et le compte d’une seule plateforme, une API de données de marché réunit de nombreux exchanges dans un format unique, et une API on-chain lit la blockchain. Genesis API est une API de données de marché en lecture seule.
- Avec une API, le trader automatise le suivi des spreads, du funding et de l’open interest, les alertes, le journal des signaux, les tableaux de bord et la recherche historique.
- Sans expérience, gardez l’exécution des ordres et les retraits en manuel : les instantanés de données sont en retard sur l’exchange, et une erreur dans votre code se répète à chaque cycle.
Une API crypto est une interface de programmation que votre code utilise pour demander des données du marché crypto et obtenir une réponse exploitable : prix, spreads entre exchanges, taux de financement (funding), open interest. Une personne lit ces chiffres dans un tableau ; un programme les reçoit sous forme de champs JSON et peut les comparer à un seuil, les enregistrer ou envoyer une alerte immédiatement. La définition générale figure dans l’entrée du glossaire API.
Requête et réponse
Travailler avec une API, c’est échanger deux messages : votre programme envoie une requête à une adresse, et le serveur renvoie une réponse. L’exemple le plus court est la vérification de l’état de Genesis API, qui ne demande aucune clé :
curl "https://api.genesisarbitrage.com/health"
{"ok":true}
curl est un programme en ligne de commande pour les requêtes HTTP ; curl --version indique s’il est installé. Les requêtes de données exigent une clé API, une chaîne par laquelle le serveur identifie votre compte et votre forfait. Un exemple illustratif : les paires Spot – Spot de la monnaie FUEL, avec la clé lue dans la variable d’environnement GENESIS_API_KEY :
URL="https://api.genesisarbitrage.com/v1/arbitrage/spot-spot"
curl "$URL?coin=FUEL" -H "X-API-Key: $GENESIS_API_KEY"
{
"success": true,
"data": [
{
"coin": "FUEL",
"exchange_buy": "ByBit",
"exchange_sell": "Gate",
"price_buy": 0.0007029,
"price_sell": 0.0007037,
"spread_pct": 0.11,
"withdraw_enabled_buy": true,
"deposit_enabled_sell": true,
…
}
],
"meta": {
"count": 1,
"updated_at": 1794675861,
"freshness_sec": 60,
"plan": "trial"
}
}
La réponse contient une paire : acheter FUEL sur ByBit à 0,0007029 et le vendre sur Gate à 0,0007037. Le spread est déjà calculé dans spread_pct : (0,0007037 − 0,0007029) / 0,0007029 × 100 ≈ 0,11 %. Les indicateurs withdraw_enabled_buy et deposit_enabled_sell montrent que les retraits depuis ByBit et les dépôts sur Gate sont ouverts, et meta.updated_at indique quand l’instantané a été construit. Le tableau Spot – Spot affiche les mêmes chiffres, et chaque champ est décrit dans la section Spot — Spot de la documentation.
L’adresse de la requête se compose d’une URL de base, du chemin d’un endpoint et de paramètres, tandis que la clé voyage à part, dans l’en-tête X-API-Key. La leçon 2 détaille chaque partie de la requête, les codes d’état et la lecture du JSON, et montre comment définir la variable de la clé.
Ce type d’échange, une requête suivie d’une réponse avec un instantané de données, s’appelle une REST API. Pour obtenir de nouvelles données, on renvoie la requête : Genesis API actualise ses données toutes les meta.freshness_sec secondes, de 60 sur Trial à 5 sur Max. Les exchanges proposent aussi un second canal, WebSocket : la connexion reste ouverte et le serveur pousse les transactions et les changements du carnet d’ordres au fur et à mesure, comme dans les flux Binance. Genesis API n’a pas de WebSocket.
Types d’API crypto
Les API crypto diffèrent par l’origine des données et par ce qu’elles permettent de faire :
- API d’exchange : données et accès au compte d’une seule plateforme. L’exchange sert publiquement les prix, les carnets d’ordres et les transactions, tandis que les soldes, les ordres et l’historique des transactions exigent une clé et une requête signée. Binance le décrit en types de sécurité :
NONEpour les données de marché ouvertes,TRADEpour passer et annuler des ordres,USER_DATApour les informations du compte (documentation Binance). - API de données de marché : de nombreux exchanges et réseaux dans un format unique. Elle fournit ce qui exige de combiner les plateformes : spreads entre exchanges, taux de funding normalisés sur une même période, open interest par exchange. Genesis API est de ce type et ne fait que lire les données.
- API on-chain : données de la blockchain, comme les transactions, les transferts de tokens et les soldes d’adresses. Les étiquettes telles que « exchange », « équipe du projet » ou « baleine » viennent de services d’analyse construits sur les données du réseau.
Une comparaison de six types d’API, REST face à WebSocket et une liste de neuf points pour choisir figurent dans le guide types d’API crypto et comment choisir.
Ce qu’un trader peut automatiser
Automatisez ce que vous répétez selon une règle fixe : ouvrir un tableau, comparer un chiffre à un seuil, noter le résultat. Un programme le fait à intervalles réguliers et ne saute pas les heures de nuit.
| Tâche | Ce que fait le programme | Données de Genesis API |
|---|---|---|
| Suivi des spreads | Paires au-dessus d’un seuil avec dépôts et retraits ouverts | /arbitrage/spot-spot, /arbitrage/spot-futures |
| Funding | Compare les taux des exchanges normalisés sur 8 heures | /funding/rates, /funding/spread |
| Open interest | Repère les variations brusques de l’OI entre 5 minutes et 1 heure | /market/open-interest |
| Alertes | Vous écrit sur Telegram quand une condition est remplie | N’importe quel endpoint de données |
| Journal | Enregistre chaque paire trouvée avec son horodatage | La réponse et meta.updated_at |
| Tableau de bord | Affiche vos colonnes et vos seuils sur votre propre page | Requêtes depuis votre serveur |
| Recherche historique | Cherche des régularités dans les données passées | /funding/analytics/daily (Pro, Max) |
Les alertes sont souvent un premier projet : le programme interroge un endpoint pas plus souvent que meta.freshness_sec et vous prévient quand un spread ou un taux franchit votre seuil. Sans code, des signaux similaires viennent des alertes Telegram de Genesis Arbitrage sur le forfait Pro du site.
Un journal permet de tester une idée avant d’engager de l’argent. Un exemple illustratif : un bot enregistre toutes les 30 secondes les paires avec un spread de 1 % ou plus, soit 86 400 / 30 = 2 880 instantanés par jour. Ils montrent combien de paires ont duré plus d’une minute et combien avaient disparu à l’interrogation suivante.
Pour l’historique, Genesis API propose l’analytique du funding, jusqu’à un an de sommes quotidiennes du funding réglé sur 13 exchanges, et l’historique du slippage du carnet d’ordres ; les deux sont sur les forfaits Pro et Max. Genesis API n’a pas de bougies historiques : ce sont les API des exchanges qui les servent, chez Binance via GET /api/v3/klines avec jusqu’à 1 000 bougies par requête (documentation Binance). Votre programme construit lui-même l’historique des spreads entre exchanges à partir des instantanés de son journal.
Ce qu’il ne faut pas automatiser sans expérience
Deux opérations coûtent cher quand elles tournent mal : l’exécution des ordres et les retraits.
Exécution des ordres
Un bot qui passe des ordres via l’API de trading d’un exchange se trompe aussi souvent qu’il s’exécute : une erreur dans la condition d’entrée avec une interrogation toutes les 10 secondes produit 3 600 / 10 = 360 ordres par heure. Les données sont aussi en retard : un instantané de Genesis API est actualisé toutes les 60 à 5 secondes selon le forfait, les carnets d’ordres retardent de 5 à 20 secondes sur l’exchange, et le spread peut se refermer dans ce délai. Genesis API ne passe pas d’ordres : il trouve les paires, et vous ouvrez la transaction vous-même sur l’exchange.
Retraits
Une clé d’exchange avec autorisation de retrait permet à quiconque la détient de sortir des fonds du compte ; la fuite d’une telle clé peut donc coûter tout le solde. Les bots qui lisent des données ou font du trading n’ont pas besoin de cette autorisation. Chez Binance, une nouvelle clé API ne peut même pas trader par défaut : l’autorisation de trading s’active séparément.
Site, API d’exchange ou Genesis API
| Tâche | Meilleur choix | Pourquoi |
|---|---|---|
| Parcourir les paires et les graphiques | Site Genesis Arbitrage | Tableaux et filtres, sans code |
| Signaux sans programmation | Alertes Telegram sur le site | Seuils réglés dans l’interface |
| Vos propres règles sur plus de 20 exchanges | Genesis API | Spreads calculés, un format unique |
| Ordres, soldes, retraits | API de l’exchange | Seul l’exchange accepte les ordres |
| Chaque transaction en temps réel | WebSocket de l’exchange | Genesis API sert des instantanés toutes les 60–5 s |
| Bougies passées | API de l’exchange | Genesis API n’a pas de bougies |
| Historique du funding sur 13 exchanges | Genesis API, Pro et Max | Jusqu’à un an de sommes quotidiennes, un format unique |
Une configuration pratique pour débuter : Genesis API trouve une paire, votre bot envoie une alerte, et vous vérifiez le carnet d’ordres de l’exchange puis ouvrez la transaction vous-même. Les forfaits Genesis API vont de Trial à 20 $ par mois (500K appels, fraîcheur de 60 s) à Max à 200 $ (10M, 5 s), et il n’y a pas de forfait gratuit. Comparez-les sur la page des tarifs de Genesis API.
Ce dont vous aurez besoin pour la suite du cours
- Une clé Genesis API : choisissez un forfait sur la page des tarifs et obtenez la clé avec le bouton « Obtenir la clé » de votre profil ; les étapes sont dans le démarrage rapide de Genesis API. Conservez la clé dans la variable d’environnement
GENESIS_API_KEYet ne la mettez jamais dans l’URL d’une requête. - curl pour vos premières requêtes depuis le terminal.
- Python 3.10+ et la bibliothèque
requests(pip install requests) pour les scripts des leçons 2 et 4. - La documentation de Genesis API : chaque endpoint a ses paramètres, ses champs, un exemple curl et un formulaire « Essayer » qui envoie la requête directement depuis la page.
Les leçons s’appuient les unes sur les autres :
- leçon 2 : votre première requête, avec l’adresse, les en-têtes, les codes d’état et le JSON ;
- leçon 3 : quelles données servent à quelles décisions, des spreads et carnets d’ordres au funding et aux flux on-chain ;
- leçon 4 : un moniteur de spreads et de funding en Python ;
- leçon 5 : les risques de l’automatisation, dont les données périmées, les erreurs, les clés et les agents IA.
Essayez vous-même
Envoyez une requête sans clé
Lancez
curl "https://api.genesisarbitrage.com/health"dans un terminal. La réponse{"ok":true}signifie que la requête est arrivée et que le serveur a répondu en JSON.Associez le tableau aux champs
Ouvrez le tableau Spot – Spot et la section Spot — Spot de la documentation. Trouvez les champs des exchanges, des prix, du spread et de l’état des transferts :
exchange_buy,price_sell,spread_pct,withdraw_enabled_buy.Listez vos tâches routinières
Prenez trois choses que vous faites chaque jour et classez chacune à l’aide du tableau ci-dessus : site, Genesis API ou API de l’exchange.
Trouvez l’endpoint pour une tâche
Pour une tâche Genesis API, trouvez l’endpoint dans la documentation et notez les paramètres nécessaires, comme
coinetmin_spread. Vous enverrez cette requête dans la leçon 2.