API crypto : types d’API de données de marché crypto et comment en choisir une pour trader
En bref
- Une API crypto donne à votre code des données de marché : prix, carnets d’ordres, taux de financement, transactions on-chain et cotations de marchés de prédiction. L’API d’un exchange couvre une plateforme et passe des ordres avec une clé ; une API de données de marché fusionne plusieurs plateformes dans un seul format.
- Choisissez une API selon neuf critères : couverture des plateformes et des chaînes, fraîcheur, normalisation des champs, statut des dépôts et des retraits, profondeur du carnet d’ordres, rate limits, prix, documentation et conditions d’utilisation des données.
- Genesis API est une API REST en lecture seule : CEX, DEX, on-chain, marchés de prédiction et surebets de bookmakers dans un seul format JSON, avec des plans à partir de 20 $ par mois. Elle ne passe pas d’ordres.
Une API crypto est une interface de programmation par laquelle le code lit des données de marché crypto ou envoie des ordres à un exchange : prix, carnets d’ordres, taux de financement (funding), transactions de la blockchain, cotations de marchés de prédiction. Les types d’API diffèrent par leur périmètre : l’API d’un exchange ne connaît qu’une plateforme et passe des ordres avec une clé, une API de données de marché fusionne plusieurs plateformes dans un seul format, et une API on-chain lit la blockchain.
Types d’API crypto
| Type d’API | Ce qu’elle fournit | Quand en avez-vous besoin |
|---|---|---|
| API d’exchange | Prix, carnets d’ordres et transactions d’un exchange ; ordres avec une clé | Trader sur cet exchange, flux de transactions d’une paire |
| API de données de marché | Plusieurs exchanges dans un seul format, spreads déjà calculés | Comparer des exchanges, scanners, alertes |
| API on-chain | Transactions, transferts, soldes, événements de contrats | Baleines, flux des exchanges, déblocages |
| API de DEX | Prix et liquidité des pools, swaps, slippage | Tokens absents des CEX, setups DEX – CEX |
| Données de dérivés | Funding, open interest, prix des futures | Arbitrage de funding, déséquilibre des positions |
| API de marchés de prédiction et de cotes | Prix YES et NO, carnets d’ordres, cotes de bookmakers | Arbitrage de marchés de prédiction, surebets |
API d’exchanges
L’API d’un exchange crypto est l’interface d’une seule plateforme, et elle comporte deux parties. La partie publique fournit des données de marché sans clé : sur Binance, ces endpoints ont le type de sécurité NONE, et GET /api/v3/ticker/price renvoie le prix d’une paire. La partie privée — ordres, soldes, historique des transactions — exige une clé API et une signature de la requête ; sur Binance, ce sont les types TRADE et USER_DATA (documentation Binance).
Une telle API couvre un seul exchange : pour comparer le prix d’un coin sur 20 exchanges, il faut 20 connexions avec des formats et des limites différents.
API de données de marché
Une API de données de marché collecte les données de nombreux exchanges, les normalise et les renvoie en une seule requête. La réponse contient déjà ce que demande la fusion des plateformes : spreads entre exchanges, taux de funding normalisés sur une même période, open interest par exchange.
API on-chain
Une API on-chain lit la blockchain : transactions, transferts de tokens, soldes d’adresses, événements de smart contracts. La couche inférieure est un nœud du réseau : tous les clients Ethereum parlent JSON-RPC, où eth_getBalance renvoie un solde en wei sous forme de nombre hexadécimal et eth_getLogs renvoie les événements de contrats correspondant à un filtre.
Un nœud ne sait pas quelles adresses appartiennent à un exchange, à une équipe ou à une baleine ; les indexeurs et les services d’analytique on-chain ajoutent ces étiquettes. Les données dont un trader a besoin sont décrites dans API de données on-chain.
API de DEX
Une API de DEX fournit les prix et la liquidité des pools sur les exchanges décentralisés, les swaps et le slippage. Plus un swap est grand par rapport à la liquidité du pool, plus il déplace le prix ; un setup DEX – CEX exige donc le slippage pour votre taille, et les nouveaux tokens demandent la taxe du token et une vérification de honeypot. Plus de détails dans API de DEX.
Données de dérivés : funding et open interest
Les futures perpétuels demandent le taux de funding, l’open interest (le volume des positions ouvertes) et le prix du future à côté du spot. Les exchanges règlent le funding toutes les 8, 4 ou 1 heures, et les taux se comparent donc après normalisation sur une même période. Plus de détails dans API de taux de funding et API d’open interest.
API de marchés de prédiction et de cotes
Les plateformes de prédiction fournissent les prix des contrats YES et NO et les carnets d’ordres. Sur Polymarket, les données de marché publiques ne demandent aucun identifiant, alors qu’un ordre exige une authentification et une signature du wallet (documentation Polymarket).
Les formats diffèrent ici aussi : le carnet d’ordres de Kalshi ne contient que des bids, et l’ask YES vaut 1 $ moins le meilleur bid NO, si bien qu’un bid NO de 0,56 $ donne un ask YES de 0,44 $ (documentation Kalshi). Les cotes des bookmakers se comparent aux prix YES et NO par la probabilité implicite — voir API Polymarket et API Kalshi et API de cotes sportives.
REST et WebSocket
Une API REST répond à une requête par un instantané filtré à votre façon, et les mises à jour s’obtiennent par polling à intervalle régulier.
Un WebSocket garde la connexion ouverte, et le serveur pousse chaque transaction et chaque changement du carnet d’ordres. En contrepartie, vous traitez le flux sans trous, vous vous reconnectez après les coupures et vous reconstruisez le carnet à partir d’un instantané plus des mises à jour, et Kalshi exige une authentification pour se connecter, même aux canaux publics. Les réactions en moins d’une seconde demandent un WebSocket ; les scanners et les alertes sur plus de 20 exchanges fonctionnent en REST.
Genesis API est uniquement REST, sans WebSocket ni webhooks : chaque requête est un GET, les réponses sont compressées en gzip au format JSON, et les données sont actualisées toutes les meta.freshness_sec secondes. Si vous répétez une requête sur l’ensemble complet, sans filtre, avec l’ETag précédent dans If-None-Match, vous obtenez un 304 sans corps quand rien n’a changé, et cette réponse ne consomme pas de quota. Les schémas de polling sont dans Bonnes pratiques de polling d’API.
Comment choisir une API crypto : checklist
Les six premiers critères se voient dans une réponse réelle de l’API ; les autres figurent dans la documentation et la grille tarifaire.
| Critère | Que vérifier |
|---|---|
| Couverture des plateformes et des chaînes | Vos exchanges, spot et futures, DEX et chaînes |
| Fraîcheur et latence | Heure de construction dans la réponse, pas d’actualisation, âge du carnet d’ordres |
| Normalisation des champs | Tickers, unités, pourcentages et heure cohérents |
| Statut des dépôts et des retraits | Indicateurs de dépôt et de retrait par exchange et par réseau |
| Profondeur du carnet d’ordres | Prix d’exécution pour votre taille |
| Rate limits et quotas | Requêtes par seconde, appels par période, ce qui compte comme un appel |
| Prix | Plan ou paiement à l’appel, ce qui se passe au-delà de la limite |
| Documentation et OpenAPI | Exemples de requêtes et de réponses, une spécification |
| Conditions d’utilisation des données | Si vous pouvez construire votre propre produit sur les données |
Couverture et fraîcheur
Vérifiez la couverture avec votre propre liste : si votre bot travaille avec MEXC et Gate, une API qui n’en couvre pas un des deux ne convient pas. La fraîcheur des données est le nombre de secondes écoulées depuis la construction de l’instantané ; la latence est tout le trajet entre une transaction sur l’exchange et votre code. Avec un instantané d’une minute, un bot voit des spreads qui n’existent déjà plus.
Normalisation des champs
La même paire BTC/USDT s’écrit différemment dans les API des exchanges : BTCUSDT sur Binance, BTC-USDT sur OKX (le perpétuel est BTC-USDT-SWAP), BTC_USDT sur Gate. Binance renvoie les prix sous forme de chaînes ("price": "4.00000200" dans l’exemple de sa documentation) et l’heure en millisecondes. Votre code doit gérer chacune de ces différences.
Une API de données de marché ramène les champs à une seule forme, comme dans cette entrée de /funding/rates tirée de la documentation de Genesis API :
{
"coin": "TON",
"exchanges": [
{
"exchange": "MEXC",
"funding_pct": 0.02,
"funding_8h_pct": 0.04,
"next_payout": "00:00",
"interval": "4h",
"price": 2.184,
"trade_url": "https://futures.mexc.com/exchange/TON_USDT"
}
]
}
MEXC règle le funding de ce coin toutes les 4 heures, et le taux de 0,02 % par intervalle est normalisé sur 8 heures dans funding_8h_pct : 0,02 × 8 / 4 = 0,04 % (voir Taux de funding).
Statut des dépôts et des retraits
Un setup spot entre exchanges n’est exécutable que si le coin peut être retiré de l’exchange d’achat et déposé sur l’exchange de vente. Sur Binance, les statuts des réseaux viennent de GET /sapi/v1/capital/config/getall, un endpoint USER_DATA signé qui exige la clé API de votre compte (documentation Binance). Dans Genesis API, les statuts arrivent dans chaque ligne Spot – Spot sous la forme withdraw_enabled_buy et deposit_enabled_sell (documentation Spot — Spot).
Profondeur du carnet d’ordres
Le spread aux meilleurs prix montre l’écart en haut du carnet, alors qu’une transaction de 5 000 $ traverse plusieurs niveaux de la profondeur de marché. Dans l’exemple de la documentation de Genesis API pour /orderbooks/spreads/spot-futures, le spread de BTC est de 0,031 % aux meilleurs prix et de 0,0202 % après avoir parcouru les carnets pour 5 000 $. L’endpoint Prix d’exécution renvoie les prix d’exécution pour 500 à 10 000 $ ; plus de détails dans API de carnet d’ordres crypto.
Limites, prix et documentation
Les limites ne se comptent pas partout de la même façon. Sur Binance, chaque endpoint a un poids, les requêtes sur de nombreux symboles pèsent plus, et une IP qui continue d’envoyer des requêtes après un 429 est bannie de 2 minutes à 3 jours (limites Binance). Pour une API de données, vérifiez le quota d’appels, le rate limit par seconde et ce qui compte comme un appel : dans Genesis API, seule une réponse 200 consomme du quota.
La tarification est soit un plan avec quota, soit un paiement à l’appel ; renseignez-vous sur ce qui se passe au-delà de la limite — une erreur 429 ou des frais supplémentaires. Une spécification OpenAPI est une description de l’API lisible par machine, pour générer un client et connecter des agents IA, et les conditions d’utilisation disent si vous pouvez construire un produit sur les données et ce que vous ne pouvez pas revendre.
Vérification en une requête
Ce script récupère l’ensemble complet Spot – Spot (disponible sur tous les plans de Genesis API) et, avec une seule réponse, vérifie la couverture, l’âge de l’instantané et la part des setups transférables :
import os
import time
import requests
BASE = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
r = requests.get(BASE + "/arbitrage/spot-spot",
headers=HEADERS, timeout=15)
r.raise_for_status()
body = r.json()
rows, meta = body["data"], body["meta"]
# Couverture : quels exchanges apparaissent dans les setups
venues = {x["exchange_buy"] for x in rows}
venues |= {x["exchange_sell"] for x in rows}
print("exchanges in response:", len(venues), sorted(venues))
# Fraîcheur : âge de l'instantané et pas d'actualisation du plan
age = time.time() - meta["updated_at"]
print(f"snapshot {age:.0f} s old, plan step {meta['freshness_sec']} s")
# Transfert : retraits ouverts côté achat, dépôts ouverts côté vente
ok = [x for x in rows
if x["withdraw_enabled_buy"] and x["deposit_enabled_sell"]]
print(f"transferable setups: {len(ok)} of {len(rows)}")
Les nouvelles tentatives sur 429 et 503 viennent de la fonction get_json de Réponses et erreurs de Genesis API. Vérifiez ensuite les prix et les statuts de 3 à 5 setups sur les exchanges via trade_url_buy et trade_url_sell.
Le construire soi-même ou utiliser une API prête à l’emploi
Pour un ou deux exchanges plus du trading, votre propre code sur leurs API est le choix naturel. Pour 20 exchanges avec spot et futures, cela représente jusqu’à 40 connecteurs de données de marché : sur Binance, le spot et les futures USDⓈ-M sont des API distinctes, api.binance.com et fapi.binance.com. Chaque connecteur embarque des instantanés REST, un flux WebSocket avec reconnexions, ses propres limites et son propre format de symboles, et il faut encore fusionner le tout : les coins sont appariés par contrat et par réseau, car un même ticker peut désigner des tokens différents selon les exchanges.
| Tâche | Votre code sur les API d’exchanges | Genesis API |
|---|---|---|
| Passer des ordres | La seule voie : l’API de trading de l’exchange | Non, lecture seule |
| Chaque transaction d’une paire | WebSocket de l’exchange | Non, instantanés toutes les 60 à 5 s |
| Spreads sur plus de 20 exchanges | Jusqu’à 40 connecteurs plus la fusion | Une requête |
| Statut des dépôts et des retraits | Un endpoint par exchange, avec une clé sur Binance | Champs dans la ligne du setup |
| DEX, on-chain, marchés de prédiction | Nœuds, indexeurs, API des plateformes | Le même format JSON |
Les approches se combinent : une API de données trouve les setups, et la position est ouverte sur l’exchange à la main ou via son API de trading avec une clé sans droit de retrait (voir Comment sécuriser votre compte d’exchange crypto). Un bot avec alertes Telegram se construit dans Bot d’arbitrage crypto en Python.
Où se place Genesis API
Genesis API est l’API REST des données de Genesis Arbitrage : CEX, DEX, on-chain, marchés de prédiction et surebets de bookmakers dans un seul format JSON, avec la clé dans l’en-tête X-API-Key. Elle sert les mêmes données que le site publie, via plus de 35 endpoints (37 opérations dans la spécification), et ne fait que lire des données.
| Données | Exemple d’endpoint | Plans API |
|---|---|---|
| Spreads CEX | /arbitrage/spot-spot | Tous |
| DEX et cross-chain | /arbitrage/dex-spot | Pro, Max |
| Carnets d’ordres | /orderbooks/exec | Pro, Max |
| Funding et OI | /funding/rates | Tous |
| On-chain | /onchain/{section} | Start, Pro, Max |
| Marchés de prédiction et surebets | /predictions/arbitrage | Start : exact, dutch ; Pro, Max : llm, sport |
Couverture : plus de 20 exchanges CEX (Binance, OKX, Bybit, Bitget, MEXC, Gate, BingX, Kraken, WhiteBit, Coinbase, CoinW, edgeX, HTX, Hyperliquid et d’autres), funding de plus de 1 000 coins normalisé sur 8 heures, open interest sur plus de 13 exchanges de futures. Les marchés de prédiction sont Polymarket, Kalshi, Limitless, Predict.fun et Opinion ; le mode sport construit des surebets de bookmakers sur 13 plateformes, avant-match uniquement.
| Plan | Appels par mois | Requêtes par seconde | Fraîcheur |
|---|---|---|---|
| Trial, 20 $/mois | 500 K | 1 | 60 s |
| Start, 50 $ | 2 M | 2 | 30 s |
| Pro, 100 $ | 5 M | 5 | 10 s |
| Max, 200 $ | 10 M | 15 | 5 s |
Les plans API sont distincts de l’abonnement au site ; vous payez en crypto, avec 10 % de réduction pour 3 mois et 20 % pour 6. Au-delà des limites, le serveur renvoie 429 et ne facture rien, et un endpoint hors de votre plan renvoie 403 plan_restricted. Comparez les plans sur Tarifs de Genesis API ; les règles sont dans Plans et limites.
Chaque section de la documentation a sa propre URL avec les paramètres, les champs, un exemple curl et un formulaire Essayer. Pour les programmes et les agents IA, il existe la spécification OpenAPI 3.1 et la référence llms-full.txt ; la configuration est décrite dans Genesis API pour les agents IA. Vous pouvez construire vos propres services, bots et tableaux de bord sur Genesis API ; vous ne pouvez pas revendre les données brutes telles quelles.
La première requête — un plan, une clé dans votre profil et un GET avec X-API-Key — est décrite dans le démarrage rapide, et les bases dans la leçon Qu’est-ce qu’une API crypto et que pouvez-vous automatiser. Sans code, les mêmes données sont dans les tableaux du site et dans les alertes Telegram.
Questions et réponses
Existe-t-il une API crypto gratuite ?
Oui : les API publiques des exchanges fournissent gratuitement et sans clé les prix, les carnets d’ordres et les transactions (sur Binance, les endpoints NONE), mais chacune ne couvre qu’un seul exchange. Genesis API n’a pas de plan gratuit : Trial coûte 20 $ par mois pour 500 K appels.
Faut-il un SDK pour utiliser une API crypto ?
Pour une API REST, un client HTTP suffit : curl, requests en Python ou fetch en JavaScript. Genesis API n’a pas de SDK officiel, et chaque requête est un GET avec un seul en-tête ; vous pouvez générer un client typé à partir de la spécification OpenAPI 3.1.
Peut-on trader via une API de données de marché ?
Pas si l’API est en lecture seule, comme Genesis API : elle trouve des setups mais ne passe aucun ordre. Les ordres passent par l’exchange, à la main ou via son API de trading avec une clé et une signature (sur Binance, les endpoints TRADE), ce qui est hors de Genesis API et à vos risques.
Comment obtenir le prix d’une crypto depuis une API ?
L’endpoint public d’un exchange renvoie le prix d’une paire sur cet exchange : sur Binance, c’est GET /api/v3/ticker/price, et le prix arrive sous forme de chaîne. Les prix d’un coin sur tous les exchanges, avec le statut des dépôts et des retraits, viennent de /coins/search?query=BTC dans Genesis API (voir Recherche de coin).