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’API | Ce qu’elle renvoie | Accès |
|---|---|---|
| API publique d’exchange | Cotations, carnets d’ordres et transactions d’un exchange | Sans clé |
| API privée d’exchange | Soldes, ordres, retraits | Clé et signature |
| Genesis API | Spreads, carnets d’ordres, funding, DEX, on-chain, marchés de prédiction | Clé, 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.