Quelles données un bot de trading crypto peut-il accéder via une clé API ?

Une Clé API pour un bot de trading n’est pas un mot de passe. Il s’agit d’une autorisation à portée limitée : une plateforme d’échange vous permet d’activer exactement trois fonctions — consulter les données de votre Compte, passer et annuler des ordres, et retirer des fonds — et un bot de trading correctement configuré n’obtient jamais que les deux premières. La troisième, le retrait, est la seule autorisation qu’un bot n’a aucune raison légitime de posséder, et toutes les grandes plateformes d’échange vous permettent de la laisser désactivée.

Les trois niveaux proposés par chaque plateforme d’échange

Binance, Bybit, OKX, Kraken et Gate.io divisent tous l’accès API en trois catégories fonctionnelles identiques, quel que soit le nom utilisé dans leurs propres menus de Paramètres :

Lire et effectuer des transactions suffisent pour qu’un Bot fasse tout ce qu’il est censé faire : vérifier le Market, ouvrir une Position, l’ajuster, la clôturer. Le retrait transfère l’argent hors de la plateforme d’échange, ce qui n’a rien à voir avec l’exécution d’une stratégie — un point que des chercheurs indépendants en Sécurité soulignent de la même manière : une analyse tierce des autorisations API des plateformes d’échange indique que les droits de transaction sont en pratique inévitables pour tout Bot, mais que le retrait est « le droit le plus dangereux » et doit rester désactivé, quelle que soit la plateforme qui le demande.

Ce que le terme « transaction » recouvre réellement sur un Bot Futures

Pour les bots Spot, l’autorisation de transaction est simple : placer et annuler des ordres d’achat/vente. Le trading Futures ajoute un peu plus sous le même volet « transaction » — un Bot utilisant une stratégie COMBO ou DCA Futures doit ouvrir et fermer des positions, et a généralement aussi besoin d’ajuster l’effet de levier et la marge sur ces positions dans le cadre de l’exécution de la stratégie. Cela reste entièrement dans le périmètre de la transaction ; cela ne nécessite pas de droits de retrait, et cela ne donne pas au Bot la possibilité de déplacer la garantie sous-jacente hors de la plateforme. Si vous connectez une clé compatible Futures, attendez-vous à voir l’ajustement de l’effet de levier/de la marge inclus dans ce que couvre l’autorisation de transaction sur cette plateforme — c’est une composante normale du même niveau, et non une autorisation distincte ou plus risquée.

L’autorisation qui neutralise réellement une clé compromise : la liste blanche d’adresses IP

Le périmètre d’autorisation n’est pas le seul levier. La plupart des plateformes permettent également de restreindre une Clé API à une adresse IP spécifique, de sorte qu’une clé divulguée devient inutilisable depuis un autre emplacement — comme le résume une analyse, « un attaquant qui intercepte la chaîne de caractères ne peut rien en faire tant qu’il n’envoie pas précisément depuis cette adresse ». Binance va plus loin et applique cette mesure par défaut : sans restriction IP définie, elle désactive automatiquement les droits de trading sur une clé après 90 jours. C’est une information à connaître en soi, indépendamment de la question du niveau d’autorisation — c’est aussi l’une des raisons les plus courantes pour lesquelles un Bot cesse discrètement de trader sans autre modification de votre part (voir pourquoi mon bot a-t-il arrêté de trader si cela vous est arrivé).

Pourquoi « trade-only » n’est pas qu’un argument marketing

Lorsqu’une plateforme affirme que ses Bots fonctionnent avec une clé limitée aux Transactions, il s’agit d’une déclaration précise et vérifiable : l’option de retrait est désactivée, et c’est la plateforme d’échange elle-même — et non la plateforme du Bot — qui applique cette restriction. Les demandes de clé de Bitsgap requièrent uniquement les autorisations de lecture et de Transaction ; si vous générez une clé sur votre plateforme d’échange avec l’option de retrait activée et tentez de la connecter, il s’agit alors d’une discordance entre ce que vous avez accordé et ce dont la plateforme a besoin, et non d’un signe qu’elle exige davantage. Pour aller plus loin sur la question de la sécurité — que se passe-t-il en cas de fuite d’une clé limitée aux Transactions, et pourquoi le statut non-custodial est plus important que le simple paramètre d’autorisation — consultez Est-il sûr de connecter l’API de votre plateforme d’échange à un bot de trading ?.

Ce que le mode lecture seule affiche réellement

Une clé en lecture seule révèle plus d’informations qu’on ne le pense, même sans droits de transaction : solde complet pour chaque actif, historique intégral des ordres, positions ouvertes, parfois adresses de dépôt. Ce n’est pas un risque pour les fonds, mais cela expose votre vie privée — c’est pourquoi il reste essentiel de limiter l’accès des clés en lecture seule aux services de confiance, et de vérifier ce que tout outil d’analyse tiers demande avant de lui accorder l’accès. Les outils de déclaration fiscale et les trackers de portfolio, par exemple, n’ont besoin que d’un accès en lecture ; si l’un d’eux réclame des droits de transaction, il faut s’interroger, car il n’existe aucune raison légitime pour qu’un outil de reporting place des ordres en votre nom.

Vérification de la portée de votre propre clé

Sur chacune des cinq plateformes d’échange mentionnées ci-dessus, la page de gestion de l’API affiche les autorisations actives de chaque clé à côté de celle-ci, généralement sous forme de boutons à bascule ou de badges. Si une clé que vous avez créée pour un Bot indique que le retrait est activé, corrigez cela immédiatement : supprimez-la et générez-en une nouvelle avec uniquement les autorisations de lecture et de Transaction activées, ainsi qu’une restriction IP si la plateforme le permet, puis reconnectez-vous. Le comportement réel du Bot ne change pas ; c’est le risque en cas de fuite de cette clé qui évolue.

Le paramètre d’autorisation que vous ne modifiez jamais est justement celui qui détermine si une clé divulguée n’est qu’un simple désagrément ou une véritable catastrophe.

FAQ

La Clé API d’un bot de trading peut-elle déplacer mes fonds hors de la plateforme d’échange ? Non, pas si la clé est correctement paramétrée. Le retrait est une autorisation distincte et optionnelle dont un bot de trading n’a aucun besoin fonctionnel : les demandes de clé de Bitsgap ne la requièrent jamais.

Quelle est la différence entre les autorisations de lecture et de transaction ? La lecture permet à un programme de consulter votre solde, vos ordres et votre historique. La transaction lui permet de passer et d’annuler des ordres. Un Bot a besoin des deux ; aucune de ces autorisations ne permet de retirer des fonds.

Un bot Futures a-t-il besoin d’une autorisation autre que lecture et transaction ? Non. L’ajustement de l’effet de levier et de la marge pour les positions Futures relève de la même autorisation de transaction : il ne s’agit pas d’un niveau de risque supérieur distinct, et cela ne donne toujours pas le droit de retirer des fonds.

L’autorisation d’IP whitelisting est-elle vraiment utile si ma clé n’a déjà aucun droit de retrait ? Oui. Elle protège contre l’utilisation abusive des autorisations dont dispose la clé : une clé limitée aux transactions, même si elle est compromise, reste inutilisable par un tiers si elle est restreinte à votre adresse IP, même s’il possède la chaîne de la clé elle-même.

Une Clé API en lecture seule est-elle totalement sans risque ? Elle ne peut pas déplacer de fonds, mais elle expose votre solde et l’historique de vos transactions à toute personne qui la détient. N’accordez l’accès en lecture qu’aux services qui en ont réellement besoin, comme les outils de reporting.