Genesis Arbitrage

Genesis Arbitrage · · 10 min de lecture

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_sell et spread_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 :

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âcheCe que fait le programmeDonnées de Genesis API
Suivi des spreadsPaires au-dessus d’un seuil avec dépôts et retraits ouverts/arbitrage/spot-spot, /arbitrage/spot-futures
FundingCompare les taux des exchanges normalisés sur 8 heures/funding/rates, /funding/spread
Open interestRepère les variations brusques de l’OI entre 5 minutes et 1 heure/market/open-interest
AlertesVous écrit sur Telegram quand une condition est remplieN’importe quel endpoint de données
JournalEnregistre chaque paire trouvée avec son horodatageLa réponse et meta.updated_at
Tableau de bordAffiche vos colonnes et vos seuils sur votre propre pageRequêtes depuis votre serveur
Recherche historiqueCherche 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âcheMeilleur choixPourquoi
Parcourir les paires et les graphiquesSite Genesis ArbitrageTableaux et filtres, sans code
Signaux sans programmationAlertes Telegram sur le siteSeuils réglés dans l’interface
Vos propres règles sur plus de 20 exchangesGenesis APISpreads calculés, un format unique
Ordres, soldes, retraitsAPI de l’exchangeSeul l’exchange accepte les ordres
Chaque transaction en temps réelWebSocket de l’exchangeGenesis API sert des instantanés toutes les 60–5 s
Bougies passéesAPI de l’exchangeGenesis API n’a pas de bougies
Historique du funding sur 13 exchangesGenesis API, Pro et MaxJusqu’à 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

Les leçons s’appuient les unes sur les autres :

Essayez vous-même

  1. 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.

  2. 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.

  3. 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.

  4. 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 coin et min_spread. Vous enverrez cette requête dans la leçon 2.