Runtime natif IA pour stratégies de trading KuCoin
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 la région.
Section 01 · En un coup d’œil
En un coup d’œil
- Plateforme
- KuCoin
- Type de plateforme
- Plateforme d'échange crypto (spot, marge, futures, options)
- Classe d’actifs
- Crypto
- Produits pris en charge
- Spot, marge croisée/isolée (jusqu'à 10x), contrats perpétuels réglés en USDT/USDC et en crypto (inverses) sur futures.kucoin.com, options de style européen BTC/ETH (réglées en USDT, acheteur uniquement, application uniquement).
- Modèle d’exécution
- Runtime de stratégie conteneurisé
- Source de déploiement
- GitHub
- Langages
- Tout langage compatible avec un conteneur
- Intégrations courantes
- REST + WebSocket natifs KuCoin, CCXT (kucoin, kucoinfutures), Freqtrade (spot validé par la communauté), Hummingbot (kucoin, kucoin_perpetual), sur mesure
- Intégration du workflow d’IA
- Interface de contrôle MCP
- Rôle de TradingHost
- Runtime, déploiement, logs, bilans de santé, choix de la région, contrôle MCP
- Rôle de KuCoin
- Compte d'échange, accès API, accès au marché, lieu d'exécution
- Affiliation
- TradingHost est indépendant et n'est pas affilié à KuCoin. KuCoin est définitivement interdit aux résidents américains suite à une ordonnance de consentement de la CFTC (mars 2026) consécutive au plaidoyer de culpabilité de Peken Global auprès du DOJ pour 297 millions de dollars en janvier 2025.
Section 02 · Ce que propose KuCoin
Ce que propose KuCoin
KuCoin propose du spot, de la marge croisée et isolée (jusqu'à 10x), des contrats perpétuels réglés en USDT/USDC et en crypto (inverses) sur futures.kucoin.com, ainsi que des options de style européen BTC/ETH via des API REST et WebSocket. Les stratégies s'authentifient à l'aide d'identifiants en trois parties (clé, secret et phrase de passe) signés avec HMAC-SHA256. Le spot et les futures sont des architectures API distinctes avec des clés séparées. Les spécificités des endpoints évoluent avec le temps. La structure globale reste stable ; les limites de requêtes précises, les paliers de frais et les listes de paires se trouvent dans la documentation de KuCoin.
Marchés et types de stratégies
- Market making spot sur les paires d'altcoins à forte liquidité
- Contrats perpétuels réglés en USDT sur futures.kucoin.com
- Contrats perpétuels réglés en crypto (inverses) sur futures.kucoin.com
- Trading sur marge croisée et isolée jusqu'à 10x
- Hiérarchie de sous-comptes pour l'isolation des stratégies
- Stratégies de copie via le programme lead trader de KuCoin
- Trading de démonstration via sandbox (spot uniquement)
- Stratégies basées sur les paliers de réduction de frais via le staking de KCS
Interface API
- Produits couverts
- Spot sur api.kucoin.com, futures sur api-futures.kucoin.com, sandbox sur openapi-sandbox.kucoin.com (spot uniquement).
- Méthodes de connexion
- REST et WebSocket. Le WebSocket nécessite un processus en deux étapes : un POST vers /api/v1/bullet-public ou /api/v1/bullet-private pour récupérer un jeton et l'endpoint wss:// réel depuis instanceServers. La logique de reconnexion doit récupérer à nouveau le jeton (celui-ci expire). Respectez les valeurs pingInterval (~18000ms) et pingTimeout (~10000ms) renvoyées.
- Authentification
- Identifiants en 3 parties (clé API + secret API + phrase de passe), signature HMAC-SHA256. En-têtes requis : KC-API-KEY, KC-API-SIGN (base64 du HMAC-SHA256 sur timestamp + méthode + endpoint + corps), KC-API-TIMESTAMP (ms depuis l'époque), KC-API-PASSPHRASE (pour les clés v2, il s'agit du base64 du HMAC-SHA256 de la phrase de passe brute, et non de la valeur brute), KC-API-KEY-VERSION ("2" pour les clés v2 actuelles). Le spot et les futures utilisent des clés API distinctes créées sur des tableaux de bord séparés.
Pour plus de détails, reportez-vous à KuCoin
Les endpoints spécifiques, les limites de requêtes, les listes de paires, les paliers de frais et l'historique des versions se trouvent dans la documentation de KuCoin. Considérez-les comme la source de vérité.
Section 03 · Développer avec l’IA
Développez votre stratégie KuCoin 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.
REST + WebSocket natifs KuCoin
Contrôle direct des comportements spécifiques à KuCoin, des données de compte, du routage des sous-comptes et de la logique d'exécution des ordres.
CCXT
Interface commune entre KuCoin et d'autres plateformes d'échange crypto. Le spot et les futures sont modélisés sous forme de deux classes d'échange : kucoin and kucoinfutures.
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 KuCoin.
Compatibilité des frameworks avec les produits KuCoin
La couverture varie selon le framework. L'API native et CCXT couvrent la plus grande partie de l'écosystème KuCoin ; Hummingbot prend en charge le spot et les futures perpétuels ; Freqtrade ne gère que le spot (validé par la communauté, le champ de phrase de passe est requis dans la configuration).
✓ compatibilité confirmée selon la documentation officielle du framework. « no » indique que la compatibilité n’est pas officiellement documentée.
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
KuCoin 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 à KuCoin.
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 à KuCoin.
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 (les identifiants en 3 parties de KuCoin : clé, secret et phrase secrète, ainsi que le paramètre KC-API-KEY-VERSION: 2 requis pour les clés v2 actuelles), puis déployez. TradingHost construit 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 KuCoin
Les pièges réels lors de l'exécution d'une stratégie KuCoin dans un runtime cloud conteneurisé, absents de la documentation KuCoin ou des fichiers README des frameworks. Chaque point ci-dessous est cité ou paraphrasé de la propre documentation de KuCoin (ou du dépôt de la CFTC pour la note sur l'accès depuis les États-Unis) ; les conseils de déploiement sont issus de l'exploitation de ces stratégies sur TradingHost.
01 · Identifiants en 3 parties
Clé, secret et phrase de passe, plus en-tête de version
Le spot et les futures nécessitent tous deux clé + secret + phrase de passe. Pour les clés v2, l'en-tête de la phrase de passe doit être le base64 du HMAC-SHA256 de la phrase de passe brute, et non la valeur brute. L'en-tête KC-API-KEY-VERSION doit être défini sur "2" pour les clés actuelles ; son omission sur une clé v2 génère une erreur de signature.
02 · Erreurs courantes
400003 et 400004 sont des échecs de phrase de passe
Une phrase de passe manquante ou mal formatée génère l'erreur 400003 KC-API-KEY not exists ou 400004 KC-API-PASSPHRASE error. CCXT a un historique documenté d'incohérences de KC-API-KEY-VERSION qui reproduisent ces erreurs.
03 · Architectures distinctes
Le spot et les futures sont des API différentes avec des clés distinctes
Les clés spot ne permettent pas de s'authentifier sur api-futures.kucoin.com. Les stratégies qui négocient sur les deux marchés ont besoin de deux paires de clés et de deux clients configurés. CCXT modélise cela sous la forme de deux classes d'échange distinctes (kucoin et kucoinfutures).
04 · WebSocket
Handshake par bullet-token, pas d'URL statique
KuCoin ne fournit pas d'URL wss:// statique. Vous devez envoyer une requête POST à /api/v1/bullet-public (flux publics) ou /api/v1/bullet-private (flux de compte/ordres) pour obtenir un jeton à usage unique et l'endpoint wss:// réel depuis instanceServers. Les jetons expirent, votre logique de reconnexion doit donc les récupérer à nouveau. Respectez les valeurs de pingInterval (~18s) et pingTimeout (~10s) renvoyées.
05 · Sandbox
Spot uniquement, environnement totalement distinct
openapi-sandbox.kucoin.com couvre uniquement le marché spot et utilise des identifiants, des clés API et un solde fictif totalement distincts. Les contrats à terme (Futures), sur marge et les options ne sont pas disponibles dans la sandbox. Les stratégies ciblant api-futures.kucoin.com doivent donc être testées à blanc par d'autres moyens (couche d'exécution simulée, positions réelles de taille minimale ou mode dry-run natif de votre framework).
06 · Limites de requêtes
Pools de ressources pondérés par niveau VIP
Les pools de ressources pondérés par niveau VIP sont réinitialisés sur une fenêtre glissante de 30 secondes. En cas de dépassement, l'API renvoie une erreur HTTP 429 avec le code 429000 dans le corps de la réponse. Chaque réponse contient des en-têtes indiquant le quota du pool, le quota restant et le compte à rebours avant réinitialisation. Plusieurs endpoints v1 (DELETE /api/v1/orders, GET /api/v1/hf/orders/active) sont obsolètes et remplacés par des versions v2/v3 offrant des limites plus élevées.
07 · Disponibilité aux États-Unis
Interdiction permanente suite à l'ordonnance de la CFTC de mars 2026
Conformément à l'ordonnance de la SDNY du 30 mars 2026 contre Peken Global Limited (l'opérateur de KuCoin), KuCoin a interdiction permanente d'accepter des clients résidant aux États-Unis, à moins que Peken Global ne s'enregistre comme Foreign Board of Trade auprès de la CFTC. Cette restriction s'applique au compte KuCoin lui-même et non au lieu d'exécution du code de votre stratégie ; les régions d'hébergement et la connectivité de TradingHost ne permettent pas de contourner cette interdiction.
Section 06 · Conçu pour
Conçu pour
Les runtimes TradingHost pour KuCoin sont particulièrement adaptés aux :
- Développeurs d'algos exécutant des stratégies spot sur le large catalogue de paires d'altcoins de KuCoin
- Traders de contrats perpétuels exécutant des stratégies avec marge en USDT ou inverses sur futures.kucoin.com
- Équipes quantitatives utilisant des sub-accounts pour isoler leurs stratégies ou gérer des poches de capital
- Utilisateurs de CCXT, Freqtrade et Hummingbot
- Développeurs IA utilisant Cursor ou Claude pour piloter leurs déploiements via MCP et GitHub
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é à KuCoin.
Non. Le code de votre stratégie se connecte à KuCoin et envoie des instructions selon votre propre logique, les autorisations de votre compte et votre méthode d'intégration. TradingHost fournit uniquement l'environnement d'exécution (runtime) où tourne ce code.
Non. L'accès à l'API est fourni directement par KuCoin. Vous êtes responsable de votre compte KuCoin, des autorisations de vos clés API, de vos identifiants et du respect des conditions d'utilisation de KuCoin.
Non. TradingHost est l'environnement d'exécution cloud où tourne le code de votre stratégie. Nous ne fournissons ni signaux, ni modèles de prédiction IA, ni stratégies prêtes à l'emploi. Avec TradingHost, vous écrivez ou générez vous-même votre stratégie (souvent avec 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 possèdent la logique de la stratégie ; TradingHost exécute la vôtre.
AWS and 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 logs, la rotation des secrets, le basculement de région 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 IA, ainsi que la gestion des logs et de l'état de santé dès le départ. Si vous préférez gérer l'infrastructure vous-même, AWS convient parfaitement. Si vous préférez un service managé, TradingHost est la solution la plus rapide.
Oui. TradingHost exécute les stratégies en Python. Choisissez l'environnement 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.
Les plateformes spot et futures de KuCoin utilisent des API distinctes (api.kucoin.com et api-futures.kucoin.com) avec des clés API différentes. Dans CCXT, cela correspond à deux classes d'échange : kucoin pour le spot et la marge, et kucoinfutures pour futures.kucoin.com. Instanciez les deux avec leurs propres clés, secrets et passphrases, orientez les ordres vers le bon client selon le symbole, et stockez les deux ensembles d'identifiants sous forme de secrets TradingHost distincts.
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 différents 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 à forker un environnement 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 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 de gestion des secrets approuvé. 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 en savoir plus sur le modèle de gestion.
Non. Les stratégies ne devraient jamais avoir besoin des autorisations de retrait. Utilisez des autorisations restreintes (lecture, trading) et la restriction par adresse IP lorsque c'est possible.
Oui. TradingHost prend en charge le contrôle basé sur MCP pour les IDE IA, notamment Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande. Les outils d'IA peuvent inspecter les déploiements, consulter les logs, redémarrer les stratégies et gérer les flux de travail de l'environnement d'exécution. MCP est une interface de contrôle et d'observabilité, et non le chemin d'exécution des transactions. Consultez la section sur l'interface de contrôle MCP pour en savoir plus.
Les deux. L'interface de contrôle MCP fonctionne aussi bien depuis des agents en ligne de commande (le CLI de Claude Code, des clients MCP personnalisés, des 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.
L'environnement d'exécution détecte le plantage et affiche les logs ainsi que les informations d'état correspondantes. Lorsque cela est pris en charge, la stratégie concernée peut être redémarrée sans perturber les autres stratégies s'exécutant 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 en savoir plus sur l'interface des logs et de l'état de santé.
Il s'agit presque toujours de l'un de ces trois problèmes. (1) L'en-tête de la passphrase pour une clé v2 doit être l'encodage base64 du HMAC-SHA256 de la passphrase brute, et non la passphrase brute elle-même. (2) L'en-tête KC-API-KEY-VERSION doit être défini sur "2" pour les clés v2. (3) Le payload de la signature doit être composé de timestamp + UPPERCASE_METHOD + endpoint_with_query + body, le corps (body) étant une chaîne vide pour les requêtes GET/DELETE. L'absence de l'un de ces éléments génère ce type d'erreur.
KuCoin ne fournit pas d'URL wss:// statique. Avant de vous connecter, vous devez envoyer une requête POST à /api/v1/bullet-public (flux publics) ou /api/v1/bullet-private (flux de compte et d'ordres). La réponse renvoie un jeton à usage unique, ainsi que instanceServers[0].endpoint, le pingInterval et le pingTimeout. Connectez-vous à ce point de terminaison avec ?token=...&connectId=..., puis envoyez un ping selon l'intervalle indiqué. Les jetons ayant une durée de vie limitée, la logique de reconnexion doit systématiquement en récupérer un nouveau.
Non. Suite à une ordonnance de consentement de la CFTC rendue le 30 mars 2026 à l'encontre de Peken Global Limited (l'opérateur de KuCoin), KuCoin a l'interdiction permanente d'accepter des résidents américains, à moins de s'enregistrer en tant que Foreign Board of Trade. Cette restriction s'applique directement au compte KuCoin et non à l'emplacement où le code de la stratégie est hébergé. Un déploiement sur TradingHost ne modifie donc en rien cette éligibilité.
Uniquement pour le Spot. openapi-sandbox.kucoin.com couvre les points de terminaison spot et utilise un compte, un jeu de clés API et un solde fictif entièrement distincts. Les contrats Futures, sur marge et les options ne sont pas disponibles dans le sandbox. Toute stratégie qui interagit avec api-futures.kucoin.com doit donc être testée d'une autre manière (couche d'exécution simulée, tailles réelles minimes ou mode dry-run natif de votre framework) avant d'augmenter les volumes.
TradingHost est disponible dans les régions EU et US-East. Choisissez la région la plus proche du moteur d'appariement dont dépend votre stratégie. Consultez la page des régions pour obtenir plus de détails sur le routage et la proximité.
Non. TradingHost se concentre exclusivement sur l'exécution en production et le déploiement. Le backtesting relève de votre environnement de recherche, de votre framework ou d'AlgoBuilder.