Genesis Arbitrage

Genesis Arbitrage · · 3 min de lecture

API

Une API (interface de programmation d’application) est un ensemble de règles par lesquelles un programme demande des données ou une action à un autre : quelle URL appeler, quoi envoyer et dans quel format la réponse arrive. Un trader a besoin d’une API quand des prix, des carnets d’ordres et des taux de financement (funding) doivent être lus par un programme : un bot, un tableur ou un tableau de bord.

Exemple de requête

Exemple hypothétique : un programme demande à Genesis API le profil de la coin IRYS via Recherche de coin, un endpoint de l’API. La requête est un HTTP GET, avec la clé dans un en-tête :

curl "https://api.genesisarbitrage.com/v1/coins/search?query=IRYS" \
  -H "X-API-Key: $GENESIS_API_KEY"

La réponse arrive en JSON, certains champs étant omis :

{
  "coin": "IRYS",
  "contracts": [
    {
      "address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
      "network": "BNB Smart Chain(BEP20)",
      "exchanges": ["MEXC", "Ourbit"]
    }
  ],
  "exchanges": {
    "MEXC": {
      "spot_price": 0.01329,
      "futures_price": 0.0133,
      "deposit": true,
      "withdraw": true
    }
  }
}

Une personne devrait assembler ces informations à partir des pages des exchanges et d’un explorateur de blocs ; un programme les reçoit en une seule réponse et calcule aussitôt que les futures de MEXC se négocient au-dessus du spot de (0,0133 − 0,01329) / 0,01329 × 100 ≈ 0,075 %.

API publiques et privées des exchanges

Une API d’exchange comporte deux parties. La partie publique sert les données de marché (cotations, carnets d’ordres, transactions) sans clé. La partie privée travaille avec votre compte (soldes, ordres, historique) et exige une clé API ainsi qu’une signature de la requête. Chez Binance, les endpoints publics ont le type de sécurité NONE ; tous les autres demandent une clé et un paramètre signature.

Les données arrivent de deux façons. Une API REST répond à chaque requête séparément : c’est ainsi qu’on obtient un instantané des données avec les filtres voulus. Un WebSocket garde la connexion ouverte et le serveur envoie les mises à jour de lui-même : c’est ainsi que Binance diffuse en temps réel les transactions et les changements du carnet d’ordres.

API de données : plusieurs plateformes dans une réponse

Une API d’exchange ne connaît que sa propre plateforme. Pour comparer le prix d’une coin sur 20 exchanges, un programme a besoin de 20 connexions, et chaque exchange a son format de réponse et ses limites. Une API de données regroupe les plateformes à l’avance.

Type d’APICe qu’elle renvoieAccès
API publique d’exchangeCotations, carnets d’ordres et transactions d’un exchangeSans clé
API privée d’exchangeSoldes, ordres, retraitsClé et signature
Genesis APISpreads, carnets d’ordres, funding, DEX, on-chain, marchés de prédictionClé, lecture seule

Une requête vers l’endpoint /arbitrage/spot-spot de Genesis API renvoie les spreads calculés entre les marchés spot de plus de 20 exchanges CEX, avec les indicateurs de dépôt et de retrait. Chaque requête est un HTTP GET, chaque réponse est en JSON, et les paramètres et champs de chaque endpoint sont dans la documentation.

Voir aussi : API crypto : types et comment choisir, démarrage rapide dans la documentation, rate limit, leçon : qu’est-ce qu’une API crypto.

Questions et réponses

Faut-il un SDK pour travailler avec une API ?

Si l’API parle HTTP, n’importe quel client HTTP convient. Pour Genesis API, curl, requests en Python ou le fetch intégré de JavaScript suffisent.

Peut-on trader via Genesis API ?

Non. Genesis API ne fournit que des données. Les ordres se passent sur l’exchange, à la main ou via l’API de l’exchange avec sa propre clé, à vos propres risques.