- L’API Binance est accessible sur developers.binance.com, et non ailleurs.
- Vous devez générer vos clés API depuis votre compte Binance, en activant la whitelist IP.
- Les endpoints publics sont sans authentification ; les privés nécessitent une signature.
- Respectez les limites de débit : 1 200 poids par minute par IP ou clé API.
- Utilisez le testnet pour vos tests avant d’opérer en réel.
Comment accéder à la documentation officielle de Binance ?
Pour commencer, rendez-vous sur developers.binance.com. C’est l’unique site officiel. Je vous conseille de vérifier le nom de domaine — les arnaques sont fréquentes. La documentation est organisée en quatre sections principales : API REST, WebSocket, trading et portefeuille. Chaque section contient des endpoints, des exemples de requêtes et des codes d’erreur. Vous y trouverez aussi les limites de débit et les bonnes pratiques. Pour les utilisateurs français, sachez que Binance n’est plus enregistré comme PSAN en France. Assurez-vous d’être en conformité avec la réglementation locale, notamment pour la déclaration de vos gains. Mais techniquement, rien ne vous empêche d’utiliser l’API.
Créer et sécuriser vos clés API : les étapes clés
Avant d’utiliser l’API, vous devez générer une paire de clés. Voici comment je procède, et je vous recommande de faire de même :
- Connectez-vous à votre compte Binance et allez dans Gestion API.
- Cliquez sur Créer une nouvelle API et choisissez le type (trading ou lecture seule).
- Notez immédiatement votre Secret Key — elle ne sera plus affichée. (J’ai déjà perdu une clé par négligence, croyez-moi.)
- Activez la whitelist IP et limitez les permissions (par exemple, désactivez les retraits si vous ne les utilisez pas).
- Activez l’authentification à deux facteurs (2FA) sur votre compte.
Ces précautions sont essentielles. Je ne peux que vous inciter à les appliquer scrupuleusement.
Comprendre la structure des endpoints REST
La documentation classe les endpoints en deux catégories : publics et privés. Les endpoints publics, comme GET /api/v3/ticker/price, ne nécessitent aucune authentification. Les endpoints privés, comme POST /api/v3/order, exigent une signature HMAC SHA256. Chaque endpoint est décrit avec sa méthode HTTP, ses paramètres et un exemple de réponse JSON. Par exemple, pour obtenir le prix du Bitcoin en euros :
GET https://api.binance.com/api/v3/ticker/price?symbol=BTCEURVous pouvez tester cela directement dans votre navigateur ou avec curl. La documentation liste toutes les paires disponibles dans la section Exchange Information. Pour les traders français, privilégiez les paires en EUR comme BTCEUR ou ETHEUR.
Effectuer votre premier appel API avec Python
Voici un exemple simple en Python pour récupérer le prix du Bitcoin :
import requests url = "https://api.binance.com/api/v3/ticker/price"
params = {"symbol": "BTCUSDT"}
response = requests.get(url, params=params)
print(response.json())Si vous voulez des données en euros, remplacez “BTCUSDT” par “BTCEUR”. C’est aussi simple que cela. Pour les flux en temps réel, vous devrez utiliser l’API WebSocket. La documentation officielle propose des exemples en Python, JavaScript et d’autres langages. Je vous conseille de commencer par le REST, puis de passer au WebSocket si vous avez besoin de données en continu.
Gérer les limites de débit (rate limits)
Binance impose des limites de requêtes pour éviter les abus. Chaque endpoint a un coût en “poids”. Par exemple, un GET simple coûte 1, un POST d’ordre coûte 5. Les limites sont :
| Type de limite | Poids maximum par minute |
|---|---|
| Par IP (endpoints publics) | 1 200 |
| Par clé API (endpoints privés) | 1 200 |
Si vous dépassez la limite, vous recevrez une erreur 429 Too Many Requests. La documentation indique d’utiliser l’en-tête Retry-After pour attendre avant de relancer. J’implémente un backoff exponentiel dans mes scripts : je commence par attendre 1 seconde, puis 2, puis 4, etc. Cela évite de bloquer mon compte.
Erreurs fréquentes à éviter
- Ignorer les codes d’erreur : chaque code (ex : -1013 pour un ordre invalide) est documenté. Ne les négligez pas.
- Oublier le fuseau horaire : Binance utilise le timestamp Unix en millisecondes. Synchronisez votre horloge système avec un serveur NTP.
- Utiliser une clé API sans restriction IP : vous exposez vos clés à un vol potentiel. Activez la whitelist IP.
- Négliger le testnet : testez toujours vos scripts sur testnet.binance.vision avant de passer en réel.
- Confondre les environnements : les clés du testnet sont différentes de celles du compte principal. Gardez-les séparées.
Une anecdote : un client m’a contacté parce que son bot passait des ordres aberrants. Il avait oublié de configurer le testnet. Résultat : des pertes. Ne faites pas la même erreur.
FAQ : réponses à vos questions
Où trouver la documentation officielle de l’API Binance ?
Sur developers.binance.com. Évitez les sites tiers.
Dois-je m’inscrire pour utiliser l’API publique ?
Non, les endpoints publics sont accessibles sans compte. Pour les endpoints privés, un compte et une clé API sont nécessaires.
Puis-je utiliser l’API Binance depuis la France ?
Oui, techniquement. Mais attention à la réglementation : Binance n’est plus enregistré comme PSAN en France. Assurez-vous d’être en conformité avec les lois françaises, notamment pour la déclaration de vos gains.
Comment obtenir des données en euros ?
Utilisez les paires de trading comme BTCEUR, ETHEUR, etc. La documentation liste toutes les paires disponibles.
Que faire en cas d’erreur 429 ?
Consultez l’en-tête Retry-After et réduisez la fréquence de vos appels. Implémentez un backoff exponentiel.
Existe-t-il un environnement de test ?
Oui, Binance propose un testnet sur testnet.binance.vision. Utilisez-le pour tester vos scripts sans risque.
Comment sécuriser ma clé API ?
Activez la whitelist IP, limitez les permissions, ne stockez jamais la Secret Key en clair dans votre code. Utilisez des variables d’environnement.
José est un passionné de technologie et un expert en cryptomonnaie avec plus de 5 ans d'expérience dans le domaine des actifs numériques. Après avoir découvert Bitcoin en 2017, il s'est plongé dans l'univers de la blockchain et des crypto-actifs, développant rapidement une expertise en trading, en analyse de marché et …
Tous les articles de José PEREZ →
