Agent Trade Kit est l’outil open source d’OKX qui donne à un assistant IA un accès direct à votre compte. Vous lui parlez comme à un assistant, il consulte le marché, passe vos ordres, pose vos stops ou lance vos bots sur OKX. Cet article explique son fonctionnement et détaille l’installation étape par étape, de la clé API aux premières requêtes de test.
Cet article vous est proposé dans le cadre d’une collaboration commerciale avec OKX (en savoir plus : OKX — plateforme crypto)
Comment ça marche
Agent Trade Kit est la boîte à outils gratuite et open source publiée par OKX pour relier un assistant IA à votre compte.
Quand vous formulez une intention en langage courant, l’IA la convertit en ordre qu’elle transmet à l’API d’OKX.
Tout s’exécute sur votre ordinateur, de sorte que vos clés API restent dans un fichier sur votre machine sans jamais être transmises au modèle, et les transactions sont signées chez vous avant de partir directement vers OKX.
La liaison avec l’outil okx-trade-mcp passe par le protocole MCP, une norme que la plupart des assistants IA supportent aujourd’hui.
Le kit s’utilise de deux manières:
- Le serveur MCP se branche sur un client IA (Claude, ChatGPT) : vous parlez à l’IA et elle agit. C’est la solution sans programmation, adaptée aux débutants.
- Tradez directement depuis votre terminal avec okx-trade-cli, sans IA, pour des scripts ou des tâches planifiées.
Les deux donnent accès aux mêmes outils.
Ce que vous pouvez faire
Le kit couvre l’ensemble du cycle de trading avec plus de 165 outils. Voici quelques exemples d’usages concrets avant de passer au tutoriel pour tout mettre en place👇
Analyser le marché avant d’agir
Vous demandez le prix d’un actif, l’état de son carnet d’ordres ou un indicateur technique comme le RSI, et l’IA répond en direct. Le kit lit aussi les chandeliers, les taux de financement et l’open interest et calcule plus de 70 indicateurs.
Comme ce module n’a pas besoin de clé API, vous pouvez tester le kit avant même de connecter votre compte. L’intérêt est que l’analyse et l’ordre se font dans la même conversation, sans copier-coller d’un onglet à l’autre.
Exemple avec okx-trade-mcp : “Quel est le prix du Bitcoin et son RSI en 4 heures ?”
Acheter et vendre
Vous indiquez le montant et le sens, l’IA place votre ordre et peut ensuite l’annuler, le modifier ou en passer plusieurs à la suite. Vous n’avez pas à chercher où se trouve chaque réglage dans l’interface, votre agent IA s’occupe de tout.
Cela fonctionne aussi bien pour le trading spot que le trading de dérivés. L’IA a également accès aux ordres plus complexes comme les trailing stop ou les déclencheurs conditionnels pour vous offrir plus de flexibilité et une meilleure gestion du risque.
Exemple : “Achète pour 100 USDC d’ETH à un prix de 2000 $ et place un stop-loss à 1800 $.”
Lancer des bots grid et DCA
Une grille (grid) achète et vend automatiquement dans une fourchette de prix que vous définissez, ce qui convient à un marché qui oscille sans tendance nette. Le DCA accumule un actif par petites tranches à intervalle régulier. Vous configurez la stratégie en langage courant plutôt que via un formulaire.
Exemple : “Crée un bot grid sur SOL-USDC entre 60 et 120 dollars avec 20 grilles.”
Suivre son portefeuille
Vous pouvez interroger vos soldes, vos positions ouvertes et leur PnL ou déclencher un transfert entre comptes, le tout sans quitter la conversation.
Exemple avec okx-trade-mcp : “Montre-moi mes positions ouvertes et leur PnL sur OKX”
Rééquilibrer son portefeuille
Vous indiquez vos allocations cibles, disons 50 % de BTC, 30 % d’ETH et 20 % d’USDC.
L’assistant lit alors vos soldes, calcule vos proportions réelles, en déduit les écarts à combler et prépare les ordres correspondants, par exemple vendre une partie du BTC pour acheter de l’ETH.
Vous validez, et l’exécution se fait dans la foulée. Une seule demande remplace le calcul manuel des montants et la saisie ordre par ordre.
Compatible avec n’importe quelle IA
Agent Trade Kit n’est lié à aucun assistant en particulier. Comme il repose sur le protocole MCP via le CLI. Il fonctionne avec Claude, ChatGPT (Codex), Grok Build, OpenCode, les modèles servis via OpenRouter ainsi que Cursor, VS Code et tout autre client compatible.
Les capacités de trading sont identiques quel que soit le client, puisque c’est le même kit qui tourne derrière. Ce qui change, c’est l’application dans laquelle vous parlez à l’IA.
Comment connecter son compte OKX à Claude
L’Agent Trade Kit permet à Claude de consulter votre compte OKX et, si vous l’autorisez, de passer des ordres à partir de simples instructions écrites.
(Si vous utilisez Codex, Grok ou Opencode, le tutoriel fonctionne également de la même façon.)
Avant de commencer
Vous devez avoir :
- un compte OKX européen (vous pouvez utiliser le lien Coinacademy pour en créer un) ;
- Claude Desktop (ou Codex, Grok…) installé sur votre ordinateur ;
- Node.js en version 18 ou supérieure.
Note : pour installer NodeJS, demandez à votre IA de l’installer pour vous en lui envoyant ce message : “installe NodeJS sur mon ordinateur car j’en ai besoin pour utiliser okx trade mcp
Étape 1 : installer l’outil OKX
Dans PowerShell ou le Terminal de votre Mac / PC sous Linux, collez cette commande :
npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli
Note : La commande dit à votre ordinateur “installe globalement via le gestionnaire de paquets npm les paquets okx-trade-mcp et okx-trade-cli”. Cette commande installe les outils qui feront le lien entre Claude et OKX
Vérifiez ensuite que l’installation fonctionne avec cette commande :
okx market ticker BTC-USDC
Si le prix du Bitcoin apparaît, l’installation est réussie. SI vous voyez un message ou plusieurs messages d’vertissement “npm warn allow-scripts”, ne vous inquiétez pas, ça fonctionne quand même.
Étape 2 : créer et enregistrer votre clé API
Entrez maintenant la commande suivante :
okx config init
Lorsque le programme vous demande la région ou le site, choisissez l’option EEA en tapant 2 sur votre clavier puis appuyez sur Entrée.
Le site EEA correspond aux comptes européens. Vous aurez ensuite le choix entre connecter votre compte démo (Y) ou votre compte réel (n), tapez “y” sur votre clavier si vous souhaitez démarrer avec un compte de démo et appuyez sur Entrée pour valider.
Une page OKX va automatiquement s’ouvrir dans votre navigateur afin de vous permettre de créer une nouvelle clé API.
Suivez les instructions affichées par OKX, puis autorisez uniquement les permissions nécessaires, comme la lecture du compte et, si besoin, le trading.
Évitez d’activer l’autorisation de retrait, ajoutez l’autorisation “trader“.
Après la création, OKX vous communique :
- API Key
- Secret Key
La Secret Key peut n’être affichée qu’une seule fois, pensez à l’enregistrer. Retournez ensuite dans le terminal, appuyez sur Entrée et copiez-collez vos clés.
Après avoir indiqué vos clés, le fichier de configuration config.toml se stocke sur votre ordinateur.
Pour tester que tout fonctionne, vous pouvez entrer ces commandes :
okx account balance
L’outil devrait afficher le solde du compte de démo.
Étape 3 : connecter OKX à Claude
Pour connecter okx via MCP à Claude Desktop, collez dans votre terminal :
okx-trade-mcp setup –client claude-desktop
Pour Claude Code, utilisez plutôt :
okx-trade-mcp setup –client claude-code
Les commandes ajoutent automatiquement le serveur OKX à Claude.
Étape 4 : redémarrer Claude
Fermez complètement l’application Claude Desktop, puis ouvrez-le à nouveau.
Vous pouvez ensuite lui demander :
Affiche le solde de mon compte OKX.
Si Claude demande l’autorisation d’utiliser un outil OKX, vous pouvez accepter.
Étape 5 : faire un premier test sans trader
Commencez uniquement avec des demandes de lecture :
Affiche mes positions ouvertes sur OKX
Affiche mes ordres actuellement en attente
Une fois que tout fonctionne, vous pouvez essayer de passer des ordres de trading sur le compte démo, puis sur votre compte réel. Il faudra créer une clé API spécifique pour votre compte réel et modifier la configuration. Voici une vidéo YouTube pour vous aider à modifier le fichier de configuration config.toml afin de passer en mode “réel” au lieu du mode démo 👇
Pour conclure
OKX est le premier grand exchange à proposer un outil qui laisse une IA passer les ordres, là où les intégrations existantes se limitaient à consulter les données.
En pratique, comptez une quinzaine de minutes pour l’installation. Vous pouvez commencer par tester les données de marché sans connecter votre compte, puis créer une clé API et vous en tenir à des demandes de lecture le temps de prendre vos marques.
Il vous faudra pour cela un compte OKX, puisque c’est lui qui génère la clé API sur laquelle repose toute la connexion. Si vous n’en avez pas encore, vous pouvez créer le vôtre via le lien Coinacademy.