Runtime natif IA pour les stratégies de trading OKX
Développez dans Cursor, Claude Code ou n'importe quel IDE IA. Déployez depuis GitHub sur un runtime cloud managé avec contrôle MCP natif, logs et choix de région.
Section 01 · En un coup d’œil
En un coup d’œil
- Plateforme
- OKX
- Type de plateforme
- Plateforme d'échange crypto
- Classe d’actifs
- Crypto
- Produits pris en charge
- Spot, swaps perpétuels, futures à échéance, options (BTC et ETH), marge, Simple Earn (flexible et fixe). Les futures à échéance BTC/ETH margés en USDT s'arrêteront d'ici le 26 juin 2026, après quoi les futures à échéance margés en USD prendront le relais.
- Modèle d’exécution
- Runtime de stratégie conteneurisé
- Source de déploiement
- GitHub
- Langages
- Tout langage s'exécutant dans un conteneur
- Intégrations courantes
- REST et WebSocket natifs OKX v5, CCXT (okx), Hummingbot (okx, okx_perpetual), Freqtrade (spot et futures, avec réserves), sur mesure
- Intégration du workflow d’IA
- Interface de contrôle MCP pour Cursor, Claude Code, GitHub Copilot et agents CLI
- Rôle de TradingHost
- Runtime, déploiement, logs, suivis de santé (health checks), choix de région, contrôle MCP
- Rôle de OKX
- Compte d'échange, accès API, accès au marché, lieu d'exécution
- Affiliation
- TradingHost est indépendant et n'est pas affilié à OKX
Section 02 · Ce que propose OKX
Ce que propose OKX
OKX propose du spot, des swaps perpétuels, des futures à échéance, des options sur BTC et ETH, ainsi que du trading sur marge via un Unified Account prenant en charge les modes multi-currency margin et portfolio margin. L'API v5 expose du REST ainsi que trois URL WebSocket (Public, Private, Business), et un environnement de démo qui utilise les noms d'hôte de production avec un en-tête `x-simulated-trading: 1` plutôt qu'un hôte testnet distinct. Les spécificités des endpoints évoluent avec le temps. La structure globale reste stable ; les limites de requêtes (rate limits), les paliers de frais et les listes de symboles précis sont disponibles dans la documentation d'OKX.
Marchés et types de stratégies
- Swaps perpétuels, margés en USDT et en coin
- Stratégies d'options sur BTC et ETH (covered calls, spreads, stratégies d'échéance)
- Mode portfolio margin (marge basée sur le risque multi-produits)
- Mode multi-currency margin (plusieurs actifs utilisés comme marge commune valorisée en USD)
- Unified Account englobant le spot, la marge, les perps, les futures et les options
- Hiérarchie de sous-comptes sous un compte principal
- Trading simulé via des clés API de démo avec l'en-tête x-simulated-trading: 1
- Passage de la démo à la production (clés de démo distinctes, puis bascule vers les clés réelles sans réécriture de code)
Interface API
- Produits couverts
- Spot, swaps perpétuels, futures à échéance, options (BTC, ETH), marge, ainsi qu'un environnement de démo (trading simulé) qui réplique les mêmes endpoints. Il n'y a pas d'hôte testnet.okx.com distinct : la démo utilise les noms d'hôte de production avec l'en-tête x-simulated-trading: 1 défini sur chaque requête et une clé API de démo créée depuis le panneau de trading de démo.
- Méthodes de connexion
- REST v5, WebSocket Public (wss://ws.okx.com:8443/ws/v5/public), WebSocket Private (wss://ws.okx.com:8443/ws/v5/private), WebSocket Business (wss://ws.okx.com:8443/ws/v5/business). Les ordres peuvent être passés, modifiés et annulés via WebSocket en plus de REST.
- Authentification
- Signature HMAC-SHA256, clé API, secret et passphrase (identifiant en 3 parties). En-têtes : OK-ACCESS-KEY, OK-ACCESS-SIGN, OK-ACCESS-TIMESTAMP (ISO 8601 UTC, ms), OK-ACCESS-PASSPHRASE. Jusqu'à 20 adresses IP autorisées par clé API. Le trading de démo utilise des clés de démo distinctes ainsi que l'en-tête x-simulated-trading: 1.
Pour plus de détails, reportez-vous à OKX
Les endpoints spécifiques, les limites de requêtes, les listes de symboles, les paliers de frais et l'historique des versions figurent dans la documentation d'OKX. Considérez-les comme la source de vérité.
Section 03 · Développer avec l’IA
Développez votre stratégie OKX avec l’IA
Choisissez une méthode d’intégration, dupliquez (fork) un starter de framework TradingHost et concevez votre stratégie dans un AI IDE. Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande fonctionnent tous avec le même cycle de déploiement natif sur GitHub.
API OKX v5 native
Contrôle direct sur le comportement spécifique à OKX, l'état de l'Unified Account, le routage des sous-comptes et la logique d'exécution des ordres.
Freqtrade ou Hummingbot
Déploiements basés sur des frameworks, utilisant leur structure de stratégie et leur modèle de configuration.
Connecteur sur mesure
Votre propre moteur de trading interne ou intégration propriétaire OKX.
Compatibilité des frameworks avec les produits OKX
La couverture varie selon le framework. CCXT couvre la plus large partie d'OKX ; Freqtrade et Hummingbot couvrent le spot et les perpétuels (Freqtrade couvre également les futures à échéance) ; l'accès natif à l'API OKX v5 couvre tout ce qu'OKX propose, y compris les options sur BTC et ETH.
✓ support confirmé selon la documentation officielle du framework. « partial » indique une couverture limitée ou restreinte aux données de marché. « no » indique qu'aucun support n'est officiellement documenté.
TradingHost n’impose aucun framework. Il exécute votre projet.
Développer avec l’IA
Les starters de framework ci-dessus s’associent naturellement avec les AI IDE. L’interface de contrôle MCP de TradingHost ferme la boucle : les outils d’IA peuvent inspecter les déploiements, consulter les journaux et gérer l’environnement d’exécution à vos côtés, sans jamais interférer avec le flux d’exécution des ordres.
Section 04 · Exécuter sur TradingHost
Exécutez votre code sur TradingHost
OKX fournit la plateforme d’échange et l’accès API. TradingHost fournit l’environnement de production où s’exécute votre stratégie connectée à OKX.
Au lieu d’exécuter le code de votre stratégie sur un ordinateur portable, un ordinateur de bureau, un VPS générique ou un serveur configuré manuellement, vous le déployez depuis GitHub dans un environnement d’exécution de conteneurs géré par TradingHost.
Vous
- Votre dépôt contient votre code.
- Votre déploiement définit son mode d’exécution.
- Votre stratégie se connecte à OKX.
TradingHost
- Maintient l’environnement d’exécution en ligne.
- Affiche les logs et les contrôles d’état.
- Sélection de la région.
- Surface de déploiement contrôlée.
Flux de déploiement
- ÉTAPE 01
Connecter GitHub
Autorisez TradingHost à accéder à votre compte GitHub.
- ÉTAPE 02
Associez un dépôt ou démarrez depuis un framework
Dirigez TradingHost vers le dépôt de votre stratégie existante, ou forkez un environnement de framework TradingHost (CCXT, Freqtrade ou Hummingbot) pour obtenir une base de travail fonctionnelle.
- ÉTAPE 03
Déployer dans un conteneur TradingHost
Choisissez une région (EU ou US-East), renseignez les variables d'environnement requises par votre stratégie (clé API OKX, secret et phrase secrète, soit les trois clés d'authentification), puis déployez. TradingHost compile votre conteneur à partir du dépôt et exécute votre stratégie sur une infrastructure Kubernetes managée. Aucune installation locale de Docker n'est requise.
- ÉTAPE 04
Suivre les logs et l’état de santé
Suivez en direct les logs, l’état de santé et l’état d’exécution depuis le tableau de bord TradingHost. Cette même interface est accessible via MCP depuis n’importe quel AI IDE, permettant à Cursor, Claude Code ou un agent en ligne de commande de lire l’état du déploiement et de gérer le runtime à vos côtés.
- ÉTAPE 05
Mettre à jour et redéployer
Poussez vos modifications sur votre branche principale GitHub et TradingHost relance automatiquement le déploiement.
Section 05 · Notes opérationnelles
Notes opérationnelles pour OKX
Les pièges concrets lorsque vous exécutez une stratégie OKX dans un runtime cloud conteneurisé, absents de la documentation d'OKX ou des fichiers README des frameworks. Chaque point ci-dessous est cité ou paraphrasé à partir de la documentation officielle d'OKX ; les conseils de déploiement sont issus de l'exploitation de ces stratégies sur TradingHost.
01 · Version de l'API
OKX utilise la v5 ; la v3 a été retirée en 2022, pas de v4
OKX a ignoré la v4 (en raison des connotations liées au chiffre 4) et est passé directement de la v3 à la v5. L'API v3 a été abandonnée le 5 janvier 2022 une fois la migration vers l'Unified Account globalement achevée. Il n'existe aucun repli possible vers la v3 aujourd'hui : toutes les intégrations doivent cibler les endpoints v5.
02 · Trading de démo
La démo utilise un en-tête et des clés distinctes, pas un hôte séparé
OKX ne propose pas d'hôte testnet.okx.com distinct. Le trading de démonstration utilise les noms d'hôte de production avec l'en-tête x-simulated-trading: 1 défini sur chaque requête, ainsi qu'une clé API de démo créée depuis le panneau de trading de démonstration. Les clés réelles (live) ne s'authentifieront pas sur l'environnement de démo, et les clés de démo échoueront silencieusement sans cet en-tête.
03 · Authentification
Identifiants en trois parties et horodatage signé
OKX requiert une clé API, un secret et une passphrase (définie lors de la création de la clé, distincte du mot de passe du compte). Les requêtes signent l'horodatage + la méthode + le requestPath + le corps du message avec HMAC-SHA256 base64 et envoient le résultat dans OK-ACCESS-SIGN. Le code 50111 correspond à une clé invalide et le code 50113 à une signature invalide, deux erreurs fréquentes en cas de passphrase manquante ou de dérive de l'horodatage.
04 · WebSockets
Trois URL WebSocket distinctes au lieu d'une seule
OKX répartit le trafic WebSocket entre Public (données de marché, sans authentification), Private (compte, exécutions, positions, ordres, authentification requise) et Business (algorithmes, grid et certains canaux spécialisés). Une stratégie qui s'abonne à un canal exclusivement Business via l'URL Public ne recevra rien et semblera inactive. La répartition des canaux par URL change occasionnellement ; consultez les notes de migration avant d'ajouter des abonnements.
05 · Mode de compte
Le mode portfolio margin est optionnel et modifie le calcul de la marge
Le Unified Account propose plusieurs modes (cash, single-currency margin, multi-currency margin, portfolio margin). Le mode multi-currency utilise les actifs convertis en USD comme marge partagée. Le mode portfolio margin applique un modèle basé sur le risque sur le spot, la marge, les contrats perpétuels, les futures et les options pour optimiser l'efficacité du capital. OKX ayant abandonné les positions en marge isolée au sein des modes multi-currency et portfolio margin, les logiques de dimensionnement des positions écrites pour le mode isolé ne sont pas transposables.
06 · Accès depuis les États-Unis
OKX global bloque les particuliers américains ; OKX US est une plateforme distincte
En février 2025, le DOJ a annoncé que l'entité affiliée à OKX, Aux Cayes FinTech Co. Ltd., avait plaidé coupable d'exploitation d'une entreprise de transfert d'argent sans licence et avait accepté des pénalités d'un montant total d'environ 505 millions de dollars (420,3 millions de dollars de confiscation, 84,4 millions de dollars d'amende). OKX global restreint l'accès aux personnes américaines par politique interne depuis 2017 ; cette restriction reste active sur okx.com. OKX a ensuite relancé une entité américaine distincte sur okx.com/en-us en 2025 (disponible dans 41 États ; le Kentucky, New York, le Texas et quelques territoires étant exclus au lancement). Les stratégies doivent cibler le point de terminaison OKX correspondant à l'entité légale de votre compte.
07 · Liste blanche d'adresses IP
Les clés API sans liste blanche d'adresses IP présentent un risque de sécurité majeur
OKX prend en charge jusqu'à 20 adresses IP par clé dans sa liste blanche et recommande vivement de lier les clés à des adresses IP spécifiques. Sans cette restriction, une clé compromise peut être exploitée depuis n'importe où. Pour les environnements de conteneurs, utilisez l'adresse IP de sortie statique de la région de votre stratégie et ajoutez-la à la liste blanche de la clé. Renouvelez la passphrase et le secret au moindre doute de compromission (la passphrase ne peut pas être récupérée).
SourceOKX API FAQ
Section 06 · Conçu pour
Conçu pour
Les runtimes TradingHost pour OKX sont particulièrement adaptés aux :
- Développeurs concevant des stratégies dans des IDE d'IA (Cursor, Claude Code)
- Traders crypto systématiques
- Développeurs quantitatifs
- Utilisateurs de CCXT, Freqtrade et Hummingbot
- Équipes migrant d'un hébergement VPS vers un déploiement conteneurisé
La connexion à GitHub et la création de votre première stratégie sont gratuites.
Section 08 · FAQ
FAQ
Non. TradingHost est indépendant et n'est pas affilié à OKX.
Non. Le code de votre stratégie se connecte à OKX et envoie des instructions selon votre propre logique, les autorisations de votre compte et votre méthode d'intégration. TradingHost fournit l'environnement d'exécution (runtime) où ce code s'exécute.
Non. L'accès à l'API OKX est fourni par OKX. Vous êtes responsable de votre compte OKX, des autorisations de vos clés API, de vos identifiants et du respect des conditions d'utilisation d'OKX.
Non. TradingHost est l'environnement d'exécution cloud où s'exécute le code de votre stratégie. Nous ne fournissons pas de signaux, de modèles de prédiction IA ou de stratégies clés en main. Avec TradingHost, vous écrivez ou générez vous-même votre stratégie (souvent à l'aide de Cursor ou Claude Code), vous la conservez sur GitHub sous forme de code, et vous utilisez TradingHost pour l'exécuter en production. Des produits comme 3Commas ou Cryptohopper détiennent la logique de la stratégie ; TradingHost se charge d'exécuter la vôtre.
AWS et DigitalOcean vous fournissent de la puissance de calcul brute. Vous devez gérer vous-même les mises à jour de l'OS, l'orchestration des conteneurs, la centralisation des journaux, la rotation des secrets, le basculement régional et la surveillance de la disponibilité. TradingHost vous offre un environnement d'exécution managé, conçu spécifiquement pour les stratégies de trading : déploiement natif depuis GitHub, contrôle piloté par MCP depuis vos IDE d'IA, et interfaces intégrées pour les logs et le suivi de l'état de santé. Si vous souhaitez gérer l'infrastructure vous-même, AWS convient parfaitement. Si vous préférez un environnement d'exécution clé en main sous forme de service managé, TradingHost est la solution la plus directe.
Oui. TradingHost exécute les stratégies Python ; choisissez l'environnement d'exécution de framework correspondant à votre stack ou déployez votre propre dépôt.
Oui. TradingHost prend en charge n'importe quel langage capable de s'exécuter dans un conteneur.
CCXT prend en charge OKX (okx, anciennement okex) pour le trading au comptant (spot) et les swaps perpétuels, ainsi que pour les données de compte, de marché et historiques. Les contrats futures sont également supportés. Les données de marché des options sont accessibles via la symbologie d'OKX, mais l'exécution des ordres d'options via les méthodes unifiées de CCXT est limitée ; orientez les ordres d'options vers le client natif OKX v5. L'objet d'échange OKX requiert apiKey, secret et password (la passphrase), ainsi que les en-têtes de sous-compte standard. Consultez l'environnement d'exécution du framework CCXT pour obtenir les détails complets de la configuration.
Oui, si votre projet est conçu ainsi. Vous pouvez exécuter plusieurs processus ou services de stratégie au sein d'un même environnement d'exécution, ou les séparer dans des environnements distincts pour plus d'isolation et de clarté opérationnelle. Consultez la page de l'environnement d'exécution TradingHost pour découvrir le modèle multi-stratégie.
La méthode la plus rapide consiste à dupliquer (fork) un environnement d'exécution de framework TradingHost : CCXT, Freqtrade ou Hummingbot pour obtenir un projet prêt à être déployé. Vous pouvez également connecter votre propre dépôt de stratégie GitHub. Lier un dépôt GitHub et créer une stratégie est gratuit ; les abonnements pour les environnements d'exécution sont détaillés sur la page des tarifs.
Dans votre flux de gestion des secrets contrôlé par GitHub. TradingHost les lit au moment de l'exécution via les secrets de dépôt GitHub, les secrets d'environnement ou votre propre processus approuvé de gestion des secrets. TradingHost n'a pas besoin de conserver votre clé API, votre secret ou votre passphrase. Consultez la section sur les secrets de la plateforme pour connaître le modèle complet de gestion.
Non. Les stratégies ne devraient jamais nécessiter d'autorisations de retrait. Utilisez des autorisations restreintes (lecture, trading) et liez la clé à l'adresse IP de sortie de votre environnement d'exécution à l'aide de la liste blanche d'adresses IP d'OKX (jusqu'à 20 adresses IP par clé).
OKX utilise un identifiant en trois parties : la clé API, le secret et la passphrase. La passphrase est une chaîne de caractères définie par l'utilisateur lors de la création de la clé API, envoyée à chaque requête authentifiée via OK-ACCESS-PASSPHRASE, et intégrée dans la signature HMAC-SHA256 aux côtés du secret. OKX ne peut pas récupérer la passphrase en cas de perte ; vous devrez alors régénérer la clé. Traitez-la comme n'importe quel autre secret.
Oui. TradingHost prend en charge le contrôle basé sur MCP pour les IDE d'IA, notamment Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande (CLI). Les outils d'IA peuvent inspecter les déploiements, consulter les logs, redémarrer les stratégies et gérer les flux de travail d'exécution. L'interface MCP est une surface de contrôle et d'observabilité, et non le chemin d'exécution des transactions. Consultez la section sur la surface de contrôle MCP pour obtenir une vue d'ensemble.
Les deux. L'interface de contrôle MCP fonctionne aussi bien depuis des agents en ligne de commande (Claude Code CLI, clients MCP personnalisés, appels MCP scriptés) que depuis un IDE. Le cycle de déploiement natif via GitHub fonctionne également sans aucun outil d'IA : un simple git push sur votre branche principale déclenche un redéploiement.
Le runtime détecte le plantage et expose les journaux (logs) et les informations d'état correspondants. Lorsque cela est pris en charge, la stratégie concernée peut être redémarrée sans perturber les autres stratégies exécutées dans le même conteneur. Le code de votre stratégie reste responsable de la gestion sécurisée des erreurs, de la protection contre les ordres doublons et des contrôles de risque. Consultez la section observabilité pour accéder aux logs et à l'état de santé.
L'erreur 50111 signifie qu'OKX n'a pas pu trouver la clé API (clé incorrecte, mauvais environnement, ou clé de démo utilisée en production). L'erreur 50113 signifie que la signature n'a pas pu être validée. Causes fréquentes : passphrase incorrecte ou manquante, secret incorrect, dérive d'horloge dans OK-ACCESS-TIMESTAMP (doit être au format ISO 8601 UTC avec une précision en millisecondes), ordre incorrect de la chaîne de pré-hachage (timestamp + method + requestPath + body), ou absence de l'en-tête x-simulated-trading: 1 lors de l'utilisation d'une clé de démo. Synchronisez l'horloge via NTP dans le conteneur et enregistrez la chaîne de pré-hachage dans les builds de non-production.
Oui. Créez une clé API de démo depuis le panneau de trading de démonstration d'OKX et ajoutez x-simulated-trading: 1 à chaque en-tête REST et WebSocket. L'hôte reste le même. Les clés de démo ne peuvent pas trader en réel, les clés réelles ne peuvent pas trader en démo, et l'en-tête est requis pour chaque appel ; basculez les deux simultanément lors du passage en production.
Le mode de compte est défini au niveau du Unified Account et affecte le calcul de la marge. Le mode multi-currency margin traite les actifs convertis en USD comme une marge partagée. Le mode portfolio margin applique un modèle basé sur le risque qui compense l'exposition sur le spot, la marge, les perps, les futures et les options. Les positions en marge isolée ne sont plus prises en charge dans les modes multi-currency ou portfolio.
La version mondiale d'OKX (okx.com) restreint l'accès aux personnes américaines en vertu d'une politique de 2017. En février 2025, Aux Cayes FinTech Co. Ltd. (affiliée à OKX) a plaidé coupable d'exploitation d'une entreprise de transfert de fonds non agréée aux États-Unis et a payé une amende de 505 millions de dollars. Une entité américaine distincte (okx.com/en-us) a été relancée en 2025 dans 41 États américains. OKX US et la version mondiale d'OKX sont des plateformes différentes ; vérifiez à quelle entité appartient votre compte avant de déployer.
TradingHost est disponible dans les régions EU et US-East. Choisissez la région la plus proche du moteur de matching dont dépend votre stratégie. Consultez la page des régions pour obtenir les détails sur le routage et la proximité.
Non. TradingHost se concentre exclusivement sur le runtime de production et le déploiement. Le backtesting relève de votre environnement de recherche, de votre framework ou d'AlgoBuilder.