Temps de lecture : … min

Runtime natif IA pour les stratégies de trading Crypto.com Exchange

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.

Par l’équipe d’ingénierie de TradingHost

Section 01 · En un coup d’œil

En un coup d’œil

Plateforme
Crypto.com Exchange (opéré par Foris DAX Limited, Îles Caïmans)
Type de plateforme
Exchange crypto centralisé
Classe d’actifs
Crypto (spot, dérivés perpétuels, marge)
Produits pris en charge
Spot, dérivés perpétuels, marge. Les dérivés sont proposés par des filiales de Crypto.com disposant de licences distinctes et font l'objet de restrictions géographiques (les juridictions exclues comprennent les États-Unis, le Royaume-Uni, Singapour et environ 110 autres pays selon la liste du centre d'aide de Crypto.com).
Modèle d’exécution
Runtime de stratégie conteneurisé
Source de déploiement
GitHub
Langages
Tout langage compatible avec les conteneurs
Intégrations courantes
API native Crypto.com Exchange v1, CCXT (`cryptocom`), FIX 4.4 (GEN 3.0, institutionnel), clients HTTP / WebSocket personnalisés
Intégration du workflow d’IA
Surface de contrôle MCP pour Cursor, Claude Code, GitHub Copilot et agents CLI
Rôle de TradingHost
Runtime, déploiement, logs, bilans de santé (health checks), choix de région, contrôle MCP
Rôle de Crypto.com Exchange
Compte d'échange, émission des clés API, accès au marché, lieu d'exécution, garde des actifs
Affiliation
TradingHost est indépendant et n'est pas affilié à Crypto.com, Foris DAX Limited ou à toute autre entité du groupe Crypto.com.

Section 02 · Ce que propose Crypto.com Exchange

Ce que propose Crypto.com Exchange

Crypto.com Exchange propose le trading spot, sur marge et sur dérivés perpétuels via une API v1 unifiée qui expose des interfaces REST, WebSocket et FIX 4.4. Les stratégies s'authentifient à l'aide de clés API signées par HMAC-SHA256 ; la hiérarchie entre comptes principaux (master) et sous-comptes (sub-accounts) est nativement prise en charge, et un bac à sable (sandbox) UAT distinct est hébergé sur `uat-api.3ona.co`. Les spécificités des endpoints évoluent avec le temps. L'architecture globale reste stable ; les quotas précis de limites de requêtes (rate-limits), les codes d'erreur et les listes d'instruments `-PERP` sont disponibles dans la documentation de Crypto.com.

Marchés et types de stratégies

  • Market making spot sur les paires CRO et stablecoins
  • Capture de base et de taux de financement (funding rate) sur les instruments `-PERP`
  • Arbitrage spot vs perp (sur une seule plateforme, deux types de produits)
  • Exécution directionnelle financée sur marge avec isolation du risque par sous-compte
  • Orchestration d'ordres à déclenchement / TP / SL via Advanced Order Management (post-janvier 2026) avec `private/advanced/create-order`
  • Exécution tagguée courtier avec `broker_id` pour les stratégies de rétrocession de frais (fee-rebate)
  • Flux sensibles à la latence via FIX 4.4 pour les desks institutionnels
  • Déploiement multi-stratégie sous un compte principal unique grâce à l'isolation des sous-comptes

Interface API

Produits couverts
Spot, dérivés perpétuels et marge via l'API unifiée Exchange v1. Les produits de Staking, Earn et d'épargne ne sont pas éligibles au trading algorithmique. Le bac à sable (sandbox) est accessible sur uat-api.3ona.co / uat-stream.3ona.co avec des clés distinctes.
Méthodes de connexion
REST et WebSocket. L'ancienne API Derivatives v1 a été intégrée à Exchange v1 ; Spot v2.1 correspond à une génération antérieure. WebSocket fonctionne sur deux flux : l'API utilisateur sur `wss://stream.crypto.com/exchange/v1/user` et les données de marché sur `wss://stream.crypto.com/exchange/v1/market`. Endpoint FIX 4.4 (GEN 3.0) disponible pour les comptes institutionnels.
Authentification
HMAC-SHA256 sur `method + id + api_key + parameter_string + nonce`, signé avec le secret API. Hiérarchie compte principal / sous-compte via `private/get-accounts`. Liste blanche d'adresses IP optionnelle par clé (requise pour les clés disposant de permissions de trading ou de retrait).

Pour plus de détails, consultez Crypto.com

Les endpoints spécifiques, les quotas de limites de requêtes, les listes d'instruments, les barèmes de frais et l'historique des versions sont disponibles dans la documentation de Crypto.com. Considérez-les comme la source de vérité unique.

Section 03 · Développer avec l’IA

Développez votre stratégie Crypto.com Exchange 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 native Crypto.com Exchange v1

    Contrôle direct sur le comportement spécifique de Crypto.com Exchange, les données de compte et la logique d'exécution des ordres. Une clé unique et unifiée gère le spot, la marge et les dérivés perpétuels ; prend en charge le marquage `broker_id` pour les flux de rétrocession de frais (fee-rebate) et les endpoints Advanced Order Management pour les ordres TP/SL et à déclenchement.

  • CCXT

    Interface commune entre Crypto.com Exchange et d'autres plateformes d'échange de cryptomonnaies. CCXT qualifie `cryptocom` de certifié et de niveau pro, avec des indicateurs de compatibilité spot, marge et swap. Considérez CCXT comme une couche de commodité ; les endpoints Advanced Order Management post-janvier 2026 suivent le contrat natif de l'API Exchange v1.

  • FIX 4.4 (GEN 3.0)

    Endpoint FIX institutionnel pour les desks sensibles à la latence. Fonctionne en parallèle des interfaces REST et WebSocket ; l'accès est soumis à l'examen du compte institutionnel par Crypto.com.

  • Client HTTP / WebSocket personnalisé

    Votre propre moteur de trading interne ou intégration propriétaire à Crypto.com Exchange via les endpoints publics REST et WebSocket.

Compatibilité des frameworks avec les produits Crypto.com Exchange

La couverture varie selon le framework. L'API native Crypto.com Exchange v1 et CCXT `cryptocom` couvrent toutes deux le spot, les perps et la marge sous une clé unique et unifiée. Freqtrade ne propose aucun support officiel pour Crypto.com Exchange et n'accède à la plateforme que via la compatibilité générique de CCXT, uniquement pour le spot. Le connecteur `crypto_com` de Hummingbot a été signalé comme obsolète après la mise à niveau vers l'API GEN 3 et ne figure pas dans la liste actuelle des plateformes d'échange de Hummingbot ; pour la production, privilégiez l'API native v1 ou CCXT.

FrameworkSpotPerpMarge
Native Crypto.com Exchange v1Pris en chargePris en chargePris en charge
CCXT (`cryptocom`)Pris en chargePris en chargePris en charge
FreqtradePartiellement pris en chargeSupport non documentéSupport non documenté
HummingbotPartiellement pris en chargeSupport non documentéSupport non documenté

✓ support confirmé selon la documentation officielle du framework. « no » indique qu'il n'est pas officiellement documenté comme supporté. « via CCXT » indique que le framework n'accède à Crypto.com que via la compatibilité générique de CCXT. « stale connector » indique un connecteur existant qui n'a pas suivi les mises à niveau de l'API de la plateforme. Les liens de workflow pointent vers les pages /workflows/ actuellement en cours de rédaction.

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

Crypto.com Exchange 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 à Crypto.com Exchange.

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 à Crypto.com Exchange.

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

  1. ÉTAPE 01

    Connecter GitHub

    Autorisez TradingHost à accéder à votre compte GitHub.

  2. ÉTAPE 02

    Associez un dépôt ou démarrez depuis un framework

    Pointez TradingHost vers votre dépôt de stratégie existant, ou dupliquez (fork) un runtime de framework TradingHost (CCXT ou votre propre modèle de départ natif pour Crypto.com Exchange) pour obtenir une base de travail fonctionnelle.

  3. É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és API Crypto.com Exchange, URL de base pour la production ou l'UAT, etc.) et 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.

  4. É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.

  5. É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 Crypto.com Exchange

Les pièges qui vous guettent lorsque vous exécutez réellement une stratégie Crypto.com Exchange dans un runtime cloud conteneurisé, absents de la documentation de Crypto.com et des fichiers README des frameworks. Chaque affirmation ci-dessous est citée ou paraphrasée à partir de la propre documentation de Crypto.com ; les conseils liés au déploiement sont issus de l'exploitation de ces stratégies sur TradingHost.

  1. 01 · Migration d'API

    Déploiement de l'API Advanced Order Management (décembre 2025 à janvier 2026)

    Crypto.com a migré les ordres à déclenchement vers `private/advanced/create-order` le 2025-12-17 08:00 UTC, et la création ainsi que l'annulation des ordres Take Profit / Stop Loss ont suivi le 2026-01-28 08:00 UTC. Le code qui appelait auparavant `private/create-order` pour les ordres TP/SL ou à déclenchement doit migrer vers l'endpoint advanced et s'abonner au flux `user.advanced.order`. Les stratégies qui n'ont pas été mises à jour avant la transition ont perdu la fonctionnalité d'ordres conditionnels.

  2. 02 · Distinction des plateformes

    L'API Exchange n'est pas l'API App

    Crypto.com exploite deux plateformes distinctes. Crypto.com Exchange (web, crypto.com/exchange) propose une API publique documentée et signée par HMAC. L'application Crypto.com App (portefeuille grand public) ne dispose pas d'API de trading publique. Les clés API générées dans l'App ne fonctionneront pas sur l'Exchange, et inversement. C'est l'erreur de configuration la plus fréquente lors de la mise en route.

  3. 03 · Accès aux dérivés

    Restrictions géographiques et segmentation des entités

    Les produits dérivés sont gérés par des filiales de Crypto.com disposant de licences distinctes (Foris DAX MT Limited à l'international ; Crypto.com Derivatives North America / CDNA aux États-Unis). Environ 110 juridictions sont exclues de la plateforme internationale de dérivés, notamment les États-Unis, le Royaume-Uni et Singapour. Les clés API Spot ne donnent pas automatiquement accès au trading de dérivés, même pour les comptes situés dans des régions éligibles.

  4. 04 · Limites de requêtes

    Quotas par méthode et par canal

    Les quotas REST par méthode sont stricts : `private/create-order`, `private/cancel-order` et `private/cancel-all-orders` sont limités à 15 requêtes par 100 ms ; `private/get-order-detail` à 30 par 100 ms ; `private/get-trades` et `private/get-order-history` à 1 par seconde ; toutes les autres méthodes privées à 3 par 100 ms. L'API REST publique est limitée à 100 rps par IP. Pour WebSocket : 150 rps sur l'API User, 100 rps sur Market Data. Tout dépassement renvoie l'erreur `42901` (HTTP 429).

  5. 05 · Cycle de vie WebSocket

    Heartbeat de 30s, préchauffage de 1s

    Le serveur émet un heartbeat toutes les 30 secondes. Le client doit répondre avec `public/respond-heartbeat` en utilisant l'identifiant `id` correspondant dans les 5 secondes, sous peine de fermeture de la connexion. Crypto.com recommande explicitement de patienter 1 seconde entre l'ouverture du WebSocket et la première requête pour éviter une limitation de débit à la connexion. Codes de fermeture à gérer : 1000 (normal), 1006 (anormal), 1013 (redémarrage du serveur, nécessite une reconnexion avec backoff).

  6. 06 · Environnements

    Le bac à sable UAT est hébergé séparément

    La production utilise api.crypto.com et stream.crypto.com. Le bac à sable UAT est hébergé sur uat-api.3ona.co et uat-stream.3ona.co et utilise des clés API distinctes. Les stratégies doivent lire les URL de base depuis des variables d'environnement plutôt que de coder api.crypto.com en dur, sous peine de voir les tests UAT cibler silencieusement la production.

  7. 07 · Erreurs d'authentification

    Échecs liés au nonce, à la signature ou à l'IP

    Trois codes d'erreur concentrent la majorité des problèmes d'authentification : `40101` (non authentifié, clé ou signature incorrecte), `40102` (décalage du nonce de plus de 60 secondes par rapport à l'heure du serveur) et `40103` (l'IP de la requête ne figure pas sur la liste blanche de la clé). L'exécution d'un conteneur dans une région dont l'IP de sortie diffère de l'IP autorisée est la cause la plus fréquente d'erreur `40103` après un déploiement.

Section 06 · Conçu pour

Conçu pour

Les runtimes TradingHost pour Crypto.com Exchange sont particulièrement adaptés aux :

  • Développeurs concevant des stratégies dans des IDE IA (Cursor, Claude Code)
  • Traders crypto systématiques
  • Développeurs quantitatifs
  • Utilisateurs de CCXT
  • É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é à Crypto.com, Foris DAX Limited ou toute autre entité du groupe Crypto.com.

Non. Le code de votre stratégie se connecte à Crypto.com Exchange et envoie des instructions selon votre propre logique, vos autorisations de 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 de Crypto.com Exchange est fourni par Crypto.com. Vous êtes responsable de votre compte Crypto.com Exchange, des autorisations de vos clés API, de vos identifiants et du respect des conditions d'utilisation de Crypto.com.

Non. TradingHost est l'environnement d'exécution cloud (runtime) où tourne 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 avec Cursor ou Claude Code), vous la conservez sur GitHub, et vous utilisez TradingHost pour l'exécuter en production. Alors que des produits comme 3Commas ou Cryptohopper gèrent la logique de trading, TradingHost se contente d'exécuter votre propre stratégie.

AWS et DigitalOcean 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 propose un environnement d'exécution managé, conçu spécifiquement pour les stratégies de trading : déploiement natif depuis GitHub, contrôle via MCP depuis vos IDE IA, ainsi que la gestion intégrée des logs et de l'état de santé. 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 directe.

Oui. TradingHost prend en charge les stratégies Python. Choisissez l'environnement d'exécution (runtime) 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.

Oui. CCXT expose Crypto.com sous l'identifiant d'échange `cryptocom` et le classe comme certifié de niveau professionnel (pro-tier) avec des fonctionnalités spot, margin et swap. Considérez CCXT comme une couche de simplification ; la gestion des limites de requêtes et les points de terminaison Advanced Order Management (post-janvier 2026) suivent le contrat natif de l'Exchange v1. Consultez la page de l'environnement d'exécution CCXT pour les détails de 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 différents environnements pour plus d'isolation et de clarté opérationnelle. La structure de comptes principaux et secondaires (master / sub-account) de Crypto.com Exchange s'y prête parfaitement : chaque stratégie peut cibler son propre sous-compte sous une clé maîtresse unique. Consultez la page de l'environnement d'exécution TradingHost pour en savoir plus sur le modèle multi-stratégie.

La méthode la plus rapide consiste à dupliquer (fork) un modèle d'environnement d'exécution TradingHost, comme CCXT, pour obtenir un projet prêt à être déployé, ou à connecter votre propre dépôt GitHub de stratégie. 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 lors de l'exécution via les secrets de dépôt GitHub, les secrets d'environnement ou votre propre processus de gestion des secrets validé. TradingHost n'a pas besoin de conserver vos clés API et secrets. Consultez la page 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. Crypto.com impose l'inscription sur liste blanche des adresses IP pour les clés disposant d'autorisations de trading ou de retrait. Excluez les retraits des autorisations de vos clés de stratégie et gérez-les séparément.

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 d'exécution. Le protocole MCP sert d'interface de contrôle et d'observabilité, et non de chemin d'exécution des transactions. Consultez la page 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 (Claude Code CLI, clients MCP personnalisés, appels MCP scriptés) que depuis un IDE. Le cycle de déploiement natif 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 de santé pertinents. 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'interface de santé.

Le code 40101 signifie que la signature HMAC-SHA256, la clé ou l'ordre des paramètres signés est incorrect ; vérifiez à nouveau la chaîne signée `method + id + api_key + parameter_string + nonce` et le tri ascendant des clés de paramètres. Le code 40102 signifie que votre nonce a un décalage de plus de 60 secondes avec l'horloge du serveur de Crypto.com ; synchronisez votre NTP. Le code 40103 signifie que l'IP de votre requête ne figure pas dans la liste blanche de la clé API ; les clés de trading et de retrait nécessitent une liste blanche d'IP. Consultez la section Notes opérationnelles ci-dessus pour obtenir le guide complet.

Crypto.com Exchange est la plateforme de trading dotée de l'API publique et documentée v1 utilisée pour le trading algorithmique ; c'est avec elle que TradingHost s'intègre. Crypto.com App est le portefeuille grand public et le produit de détail ; il ne publie pas d'API de trading. Les clés API sont générées dans l'interface web de l'Exchange sous User Center > API, et non dans l'application mobile.

La création et l'annulation des ordres Take Profit et Stop Loss ont été déplacées de `private/create-order` vers `private/advanced/create-order` le 2026-01-28 08:00 UTC, après la migration des ordres à déclenchement (trigger orders) le 2025-12-17 08:00 UTC. Les stratégies doivent désormais appeler le point de terminaison avancé pour les ordres conditionnels et s'abonner à `user.advanced.order` pour les mises à jour d'état. Les ordres simples limit et market continuent d'utiliser `private/create-order`.

Sur la plateforme internationale, la clé API unifiée Exchange v1 peut cibler le spot, la marge et les perpétuels avec un seul identifiant, mais l'autorisation sous-jacente pour les produits dérivés est liée au compte, pas à la clé. Les dérivés doivent être activés sur le compte et celui-ci doit être domicilié dans une juridiction non exclue. Aux États-Unis, les dérivés sont gérés par une filiale sous licence distincte (CDNA) avec son propre processus d'inscription.

Freqtrade peut accéder à Crypto.com via CCXT mais n'est pas officiellement pris en charge par l'équipe de Freqtrade. Le connecteur `crypto_com` de Hummingbot est marqué comme obsolète depuis la mise à niveau de l'API GEN 3 et ne figure pas dans la liste actuelle des plateformes d'échange de Hummingbot ; considérez-le comme non pris en charge et utilisez directement CCXT ou l'API native v1.

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 des détails sur le routage et la proximité.

Non. TradingHost se concentre exclusivement sur l'environnement d'exécution (runtime) de production et le déploiement. Le backtesting relève de votre environnement de recherche, de votre framework ou d'AlgoBuilder.