La permission en lecture seule de l'API Binance (affichée « Enable Reading » dans l'interface) ne peut que lire des données : elle ne permet ni de passer des ordres, ni de les annuler, ni de retirer des fonds, ce qui la rend adaptée à la consultation du marché, au rapprochement des actifs et à l'autorisation d'outils de comptabilité tiers. Pour créer une clé, connectez-vous d'abord à l'espace de compte du Site Officiel de Binance ; les utilisateurs mobiles peuvent aussi consulter les clés existantes dans l'Application Officielle Binance, et les utilisateurs d'iPhone peuvent suivre le guide d'installation iOS. Il faut garder à l'esprit qu'une clé en lecture seule ne peut pas déplacer de fonds mais révèle les soldes et l'historique des transactions : elle reste donc une information sensible, à ne pas confier à la légère.
Ce que la permission en lecture seule peut et ne peut pas faire
R : La permission en lecture seule permet de consulter les soldes du compte, les ordres ouverts, l'historique des ordres, le détail des transactions, les dépôts et les retraits. Elle ne permet ni de créer un ordre, ni de l'annuler, ni de lancer un retrait. Lorsqu'une clé API est créée sur Binance, seule la permission de lecture est cochée par défaut ; les permissions de trading, de retrait, de contrats à terme et autres doivent être activées manuellement.
L'intérêt de l'accès en lecture seule est de séparer « voir les données » de « déplacer des fonds ». Une fois la clé en lecture seule confiée à un outil de rapport, à une application de comptabilité ou à un script personnel, un attaquant qui l'obtiendrait ne pourrait toujours ni transférer d'actifs ni passer d'ordres sur le marché : les dégâts se limitent à la confidentialité.
Le tableau ci-dessous compare les capacités des types de permission courants. Les noms et options exacts sont ceux que la page de gestion des API de Binance affiche à ce moment-là :
| Type de permission | Consultation des soldes et historiques | Passer ou annuler des ordres | Retirer | Principal risque en cas de fuite |
|---|---|---|---|---|
| Lecture seule (Enable Reading) | Oui | Non | Non | Positions et habitudes de trading exposées |
| Trading spot et sur marge | Oui | Oui | Non | Ordres malveillants entraînant des pertes |
| Trading de contrats à terme | Oui | Oui (compte de contrats à terme) | Non | Positions malveillantes ou liquidation |
| Autoriser les retraits | Oui | Selon les autres cases | Oui | Actifs transférés directement |
Le tableau montre que la clé en lecture seule présente le risque le plus faible des quatre configurations. Pour les usages qui consistent seulement à consulter des données, il faut choisir la lecture seule en priorité, plutôt que de cocher toutes les permissions par commodité.
Différence entre les données de marché publiques et une clé en lecture seule
R : Les points d'accès publics de marché ne nécessitent aucune clé ; la clé en lecture seule sert à consulter les données de son propre compte. Les points d'accès de marché de Binance, tels que le dernier prix, les bougies, la profondeur du carnet d'ordres et les statistiques sur 24 heures, sont des données publiques que n'importe qui peut appeler sans se connecter.
De nombreux débutants croient qu'interroger les prix exige aussi une clé API, alors qu'une seule requête HTTP suffit. La commande ci-dessous interroge directement le dernier prix de BTCUSDT :
curl "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"
La réponse est un fragment JSON contenant le nom de la paire et le dernier prix échangé. Seules les données liées à un compte personnel, comme les soldes, les ordres ouverts et l'historique des transactions, exigent une API Key et une requête signée.
| Élément | Points d'accès publics de marché | Points d'accès avec clé en lecture seule |
|---|---|---|
| API Key requise | Non | Oui |
| Signature requise | Non | Oui (HMAC-SHA256) |
| Données disponibles | Prix, bougies, profondeur, transactions | Soldes, ordres, transactions, dépôts et retraits |
| Concerne la vie privée | Non | Oui |
| Usage typique | Suivi des graphiques, tableaux de bord, backtests de stratégie | Rapprochement, comptabilité, suivi des positions |
Trois usages typiques de la permission en lecture seule
R : Les trois usages les plus courants d'une clé en lecture seule sont le rapprochement des actifs, le suivi des positions et l'autorisation d'outils tiers. Aucun des trois ne nécessite d'accéder aux fonds ; chacun a seulement besoin de lire les données du compte de manière stable.
Usage 1 : le rapprochement des actifs
Le rapprochement des actifs consiste à comparer, ligne par ligne, les soldes réels du compte Binance avec son propre registre ou son tableur. En lisant la liste des actifs par le point d'accès en lecture seule et en additionnant ses propres enregistrements d'achats, de ventes, de dépôts et de retraits, on peut repérer des frais oubliés, des transferts non enregistrés ou des transactions que l'on a omis de noter.
Trois chiffres comptent généralement lors du rapprochement : le solde disponible, le solde gelé et la valorisation. Le solde gelé provient des ordres ouverts non exécutés ; il est facile à négliger et explique souvent que le registre ne corresponde pas aux données renvoyées par l'API.
Usage 2 : le suivi des positions
Le suivi des positions consiste à récupérer les actifs du compte à intervalles réguliers, puis à les multiplier par les prix publics du marché pour obtenir une valorisation totale. De nombreux tableaux de bord personnels, widgets d'écran d'accueil de téléphone et scripts d'alerte fonctionnent ainsi.
Ces scripts ne font que lire des données : une clé en lecture seule suffit. Que le script tourne sur un ordinateur personnel, un Raspberry Pi ou un serveur cloud, il n'est pas nécessaire d'activer la permission de trading.
Usage 3 : l'autorisation d'outils tiers de comptabilité et de fiscalité
Certains outils de comptabilité, d'agrégation de portefeuille et de préparation fiscale demandent aux utilisateurs une clé API en lecture seule pour synchroniser l'historique des transactions. Ces outils n'ont pas besoin de passer d'ordres : la permission en lecture seule est donc suffisante ; si un outil réclame la permission de retrait, il faut interrompre immédiatement l'autorisation et vérifier sa provenance.
Étape 1 à étape 4 : créer une clé API en lecture seule
R : La création d'une clé en lecture seule demande en général quatre étapes : se connecter, ouvrir la gestion des API, créer et nommer la clé, puis enregistrer le Secret et confirmer les permissions. La position des menus sur le site Binance et dans l'application peut changer d'une version à l'autre ; il faut suivre la page réellement affichée.
Étape 1 : se connecter et préparer la vérification
Connectez-vous d'abord au Site Officiel de Binance, vérifiez que le compte a terminé la vérification d'identité requise et que l'authentification à deux facteurs (2FA) est activée. Lors de la création d'une clé API, Binance demande généralement de confirmer l'opération par 2FA, par e-mail ou par un code SMS.
Étape 2 : ouvrir la page de gestion des API
Repérez l'entrée « Gestion des API » dans le centre de compte et choisissez de créer une nouvelle clé API. Binance permet de choisir le type de clé généré par le système et de saisir un libellé pour la clé. Un libellé qui indique l'usage, par exemple « lecture seule - outil de comptabilité », facilite la distinction des clés par la suite.
Étape 3 : vérifier les permissions et lier une IP
Après la création, la page de la clé affiche une liste de permissions. Une clé destinée à la lecture seule doit conserver « Enable Reading » activé, et il faut s'assurer que les permissions de trading, de retrait et les autres sont désactivées. Il est aussi conseillé de renseigner une restriction d'accès par IP afin que seul votre propre serveur ou une adresse de sortie fixe puisse appeler l'API.
Étape 4 : enregistrer la Secret Key
L'API Key peut être consultée à tout moment sur la page, mais la Secret Key n'est généralement affichée en entier qu'une seule fois, à la création. Enregistrez immédiatement le Secret dans un gestionnaire de mots de passe ou dans un fichier chiffré ; ne l'envoyez pas en capture d'écran dans un groupe de discussion et ne l'écrivez pas dans un dépôt de code public. Pour connaître les options de stockage, consultez sur ce site l'article consacré à la conservation sécurisée des clés API de Binance.
Le déroulement de base d'une consultation de compte avec une clé en lecture seule
R : Une requête de lecture signée comporte trois éléments : l'API Key placée dans l'en-tête de la requête, des paramètres qui incluent un horodatage, et la signature ajoutée à la fin de la chaîne de requête. La signature se calcule en appliquant HMAC-SHA256 à la chaîne de paramètres avec la Secret Key.
L'exemple Python ci-dessous lit la clé dans les variables d'environnement, puis interroge les informations du compte spot :
import os, time, hmac, hashlib, requests
API_KEY = os.environ["BINANCE_API_KEY"]
API_SECRET = os.environ["BINANCE_API_SECRET"]
query = f"timestamp={int(time.time() * 1000)}"
signature = hmac.new(API_SECRET.encode(), query.encode(), hashlib.sha256).hexdigest()
resp = requests.get(
f"https://api.binance.com/api/v3/account?{query}&signature={signature}",
headers={"X-MBX-APIKEY": API_KEY},
)
for item in resp.json()["balances"]:
if float(item["free"]) > 0 or float(item["locked"]) > 0:
print(item["asset"], item["free"], item["locked"])
Le code n'affiche que les soldes non nuls. Si une requête renvoie 401 ou une erreur de permission, vérifiez d'abord que la clé a bien la permission de lecture cochée et que l'IP appelante figure dans la liste blanche. Les autres détails de signature sont traités dans l'article de ce site sur la génération des signatures de l'API Binance.
Les points d'accès de lecture courants comprennent les informations du compte, les ordres ouverts, l'historique des ordres, les transactions du compte, l'historique des dépôts et celui des retraits. Les chemins et paramètres exacts sont ceux de la documentation officielle de l'API Binance.
Comment se déroule concrètement le rapprochement des actifs
R : Le rapprochement des actifs consiste à fixer d'abord un instant de référence, puis à comparer les données de l'API avec ses propres enregistrements, ligne par ligne. On évite ainsi les écarts causés par des données qui évoluent en temps réel.
Les étapes suivantes conviennent aux particuliers et aux petites équipes :
- Choisissez l'instant du rapprochement, par exemple une heure fixe le dernier jour de chaque mois, et notez son horodatage.
- Lisez par le point d'accès en lecture seule les soldes disponibles et gelés de chaque actif à cet instant.
- Lisez les enregistrements de transactions, de dépôts et de retraits de la période.
- Prenez le solde de clôture précédent, ajoutez les entrées de la période et retranchez les sorties pour obtenir le solde théorique.
- Comparez le solde théorique avec le solde réel renvoyé par l'API et examinez les écarts actif par actif.
Quand des écarts apparaissent, les causes les plus fréquentes sont des frais prélevés dans un autre actif (par exemple en payant avec du BNB), des conversions de petits actifs, des récompenses de promotions créditées et des transferts non enregistrés entre comptes (spot, financement, contrats à terme). Lors de l'enquête, il faut vérifier chaque actif séparément plutôt que de tout comparer ensemble.
| Origine de l'écart | Symptôme typique | Comment enquêter |
|---|---|---|
| Prélèvement de frais | Solde légèrement inférieur à l'attendu | Vérifier l'actif des frais dans les transactions |
| Transferts entre comptes | Le solde spot change soudainement | Comparer avec l'historique des transferts |
| Récompenses de promotions et airdrops | Le solde comporte une entrée en plus | Consulter les mouvements de fonds et les annonces |
| Solde gelé | Le solde disponible paraît faible | Consulter les ordres ouverts actuels |
| Conversion de petits actifs | Plusieurs petits actifs disparaissent | Vérifier les enregistrements de conversion |
Risques et consignes de sécurité liés aux clés en lecture seule
R : Une clé en lecture seule ne peut pas entraîner le transfert de fonds, mais elle expose les positions et le comportement de trading ; elle doit donc être conservée comme un identifiant sensible. Si quelqu'un obtient les informations sur les positions, elles peuvent servir de matière à des attaques d'ingénierie sociale et à des arnaques par hameçonnage.
Voici quelques règles de sécurité de base :
- Ne cochez pas les permissions de trading, de contrats à terme ou de retrait sur une clé destinée à la lecture seule ; moins il y a de permissions, plus c'est sûr.
- Définissez une restriction d'accès par IP sur la clé afin que seule votre adresse fixe puisse l'utiliser.
- Utilisez une clé distincte pour chaque outil ou script, afin de pouvoir les révoquer séparément.
- N'envoyez jamais de clés à une personne se présentant comme le support ou un service de « gestion de compte » ; Binance ne demande jamais officiellement la Secret Key.
- En cas d'appels anormaux ou lorsqu'un outil n'est plus utilisé, supprimez aussitôt la clé correspondante sur la page de gestion des API.
- Si un outil tiers réclame la permission de retrait, considérez-le comme un signal de risque élevé et refusez l'autorisation.
Rappelons aussi que ce site est un site de tutoriels tiers indépendant et non le site officiel de Binance. Les noms des permissions de l'API, les points d'entrée des pages et les restrictions sont ceux qu'affichent actuellement les pages et la documentation officielles de Binance. Les prix des cryptoactifs fluctuent fortement et l'investissement comporte des risques ; les utilisateurs de Chine continentale doivent s'informer et respecter la législation locale lorsqu'ils utilisent les services concernés.
Questions fréquentes
Q : Quelqu'un peut-il utiliser la permission en lecture seule de l'API Binance pour retirer des fonds ? R : Non. La permission en lecture seule n'inclut pas la capacité de retrait ; les retraits exigent la permission distincte « Autoriser les retraits ». Toutefois, si une clé en lecture seule fuit, les positions et l'historique des transactions peuvent être vus : il faut donc la supprimer et la recréer rapidement.
Q : Faut-il une clé API juste pour consulter les prix du marché ? R : Non. Les points d'accès publics de marché, comme le dernier prix, les bougies et la profondeur, n'exigent ni clé ni signature ; il suffit d'envoyer une requête HTTP.
Q : Peut-on utiliser une clé en lecture seule sans liste blanche d'IP ? R : C'est possible, mais déconseillé. Avec une restriction d'IP, les autres adresses ne peuvent pas utiliser la clé même si elle fuit. Les utilisateurs d'une IP dynamique peuvent relayer leurs requêtes via un serveur cloud à adresse de sortie fixe.
Q : Une clé en lecture seule peut-elle voir les données du compte de contrats à terme ? R : Un compte de contrats à terme exige généralement d'activer séparément les options liées aux contrats à terme dans les permissions de la clé avant de pouvoir lire ses données via l'API. Les options exactes sont celles qu'affiche la page de gestion des API de Binance.
Q : Un outil de comptabilité tiers me demande ma clé en lecture seule. Est-ce sûr ? R : Côté permissions, la lecture seule est relativement sûre, mais il faut vérifier que l'outil provient d'une source fiable et dispose d'une déclaration de confidentialité claire, créer une clé dédiée et la supprimer quand l'outil n'est plus utilisé.
Q : Que faire si un appel en lecture renvoie une erreur de permission ? R : Vérifiez d'abord que la clé a la permission de lecture cochée, puis si l'IP appelante figure dans la liste blanche et si l'horloge du système ne s'écarte pas trop de l'heure des serveurs Binance, et enfin que la signature est correcte.
Q : Faut-il remplacer régulièrement une clé en lecture seule ? R : Une rotation régulière est conseillée, avec un remplacement immédiat après un changement de personnel, la mise hors service d'un outil ou en cas de soupçon de fuite. Il n'existe pas de périodicité universelle ; à chacun de la fixer selon sa tolérance au risque.
Si vous n'avez pas encore de compte Binance, vous pouvez d'abord finaliser l'inscription et la vérification sur le Site Officiel de Binance, puis créer la clé en lecture seule en suivant les étapes de cet article ; sur mobile, l'Application Officielle Binance peut être installée pour consulter l'état des clés à tout moment.