Runtime natif IA pour stratégies de trading AscendEX
Concevez vos stratégies 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
- AscendEX
- Type de plateforme
- Plateforme d'échange crypto (anciennement BitMax)
- Classe d’actifs
- Crypto
- Produits pris en charge
- Compte cash (spot), compte sur marge (margin) et compte à terme (futures v2) ; positions futures en marge isolée et croisée
- 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
- API natives AscendEX REST et WebSocket, CCXT, Freqtrade, Hummingbot, connecteurs personnalisés
- 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, bilans de santé, choix de la région, contrôle MCP
- Rôle de AscendEX
- Compte d'échange, accès API, accès au marché, lieu d'exécution
- Affiliation
- TradingHost est indépendant et n'est pas affilié à AscendEX
Section 02 · Ce que propose AscendEX
Ce que propose AscendEX
AscendEX (anciennement BitMax jusqu'en mars 2021) divise chaque compte en trois objets distincts (cashAccount, marginAccount, futuresAccount). De plus, chaque URL de requête privée doit inclure la valeur `accountGroup` propre à l'utilisateur, renvoyée lors de la première authentification. L'API futures v2 dispose de sa propre documentation. Les anciens domaines BitMax (bitmax.io, btmx.com, btmx.io) ont été mis hors service en mai 2021 et ne sont plus accessibles. Les spécificités des endpoints évoluent avec le temps. Si l'architecture globale reste stable, les limites de requêtes exactes, les paliers de frais et les listes de symboles sont à consulter directement dans la documentation d'AscendEX.
Marchés et types de stratégies
- Stratégies spot sur paires USDT
- Prêt sur marge et spot en marge isolée
- Contrats à terme perpétuels avec marge en USDT (API v2)
- Transferts internes entre comptes cash, margin et futures
- Positions futures en marge isolée et croisée
- Clés API limitées à un objet de compte spécifique
- Consommation des flux de carnets d'ordres et de transactions via WebSocket
- Déploiements multi-stratégies isolés par sous-comptes
Interface API
- Produits couverts
- Les comptes AscendEX contiennent trois objets de compte distincts : cashAccount (spot), marginAccount (marge) et futuresAccount (futures v2). Les transferts entre ces comptes doivent être demandés explicitement. L'API futures v2 possède son propre ensemble de documentation ; les anciens domaines BitMax (bitmax.io, btmx.com, btmx.io) ont été désactivés en mai 2021 et ne sont plus routables.
- Méthodes de connexion
- REST pour le passage d'ordres et les requêtes de compte, avec l'obligation d'inclure la valeur `accountGroup` comme préfixe du chemin d'URL pour les requêtes privées (cette valeur est renvoyée par l'endpoint d'informations de compte lors de la première authentification). WebSocket pour les données de marché et les événements de compte privés. Les flux WebSocket publics sont ouverts ; les abonnements privés requièrent une authentification.
- Authentification
- Clé API et secret signés avec HMAC-SHA256. L'endpoint d'informations de compte renvoie lors de la première authentification la valeur `accountGroup`, qui doit ensuite préfixer chaque URL de requête privée. Une clé est valide pour un type de compte spécifique (cash, margin ou futures) ; utiliser une clé de compte cash sur un endpoint futures renverra une erreur d'autorisation plutôt qu'une redirection transparente.
Pour plus de détails, reportez-vous à AscendEX
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'AscendEX. Considérez-les comme la seule source de vérité.
Section 03 · Développer avec l’IA
Développez votre stratégie AscendEX 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 AscendEX
Contrôle direct des spécificités d'AscendEX, notamment le schéma d'URL préfixé par accountGroup et la séparation des comptes en objets cash/margin/futures.
CCXT
Interface commune pour AscendEX et d'autres plateformes d'échange crypto. CCXT expose les marchés spot et swap d'AscendEX via la classe unifiée `ascendex`.
Freqtrade ou Hummingbot
Déploiements basés sur des frameworks, utilisant leur structure de stratégie et leur modèle de configuration. Les deux listent AscendEX parmi les plateformes d'échange prises en charge.
Connecteur personnalisé
Votre propre moteur de trading interne ou intégration propriétaire AscendEX, gérant la détection de l'accountGroup et le schéma de signature HMAC-SHA256.
Compatibilité des frameworks avec les produits AscendEX
La couverture varie selon le framework. CCXT prend en charge les marchés spot et swap d'AscendEX, y compris les futures v2 ; Freqtrade couvre le spot ; Hummingbot couvre le spot avec un support partiel des swaps ; l'API native AscendEX couvre l'intégralité de l'offre d'AscendEX, y compris les transferts internes entre comptes cash, margin et futures.
✓ support confirmé selon la documentation officielle du framework. « no » indique qu'aucun support n'est officiellement documenté. « partial » indique une couverture limitée. Les liens de workflow renvoient vers les pages /workflows/ 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
AscendEX 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 à AscendEX.
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 à AscendEX.
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 AscendEX, secret et la valeur accountGroup renvoyée par le point de terminaison account-info), puis déployez. TradingHost génère 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 AscendEX
Les pièges qui vous guettent lorsque vous exécutez réellement une stratégie AscendEX dans un runtime cloud conteneurisé — absents de la documentation d'AscendEX et des fichiers README des frameworks. Chaque point ci-dessous est cité ou paraphrasé à partir de la documentation officielle d'AscendEX ; les conseils de déploiement sont issus de l'exploitation de ces stratégies sur TradingHost.
01 · accountGroup
Les requêtes privées nécessitent un préfixe accountGroup dans l'URL
Les requêtes privées AscendEX sont routées sous `https://ascendex.com/<accountGroup>/api/pro/...`. La valeur `accountGroup` est propre à chaque utilisateur et est renvoyée par l'endpoint d'informations de compte lors de la première authentification. Une erreur silencieuse courante consiste à coder en dur l' `accountGroup` avec une valeur connue dans un modèle de départ, en oubliant qu'il diffère d'un compte à l'autre ; les requêtes privées renvoient alors une erreur 404 ou une erreur de routage, même si la clé est correcte. Récupérez l' `accountGroup` une seule fois au démarrage de la stratégie et mettez-le en cache dans l'environnement du runtime pour toute la durée du déploiement.
02 · Account objects
Cash, margin et futures sont trois objets de compte distincts
Un compte utilisateur AscendEX contient trois objets de compte : `cashAccount` (spot), `marginAccount` (marge) et `futuresAccount` (futures v2). Chacun possède son propre solde et sa propre portée d'API. Les transferts entre eux s'effectuent via des endpoints explicites, et non par des mouvements de marge implicites. Une stratégie qui prévoit de liquider une position futures vers le compte spot doit appeler l'endpoint de transfert après la clôture de la position ; cela ne se fait pas automatiquement. Générez des clés dédiées par objet de compte pour vos stratégies de production afin d'éviter qu'une clé de compte cash ne puisse accidentellement passer un ordre futures.
03 · Domaines obsolètes
bitmax.io, btmx.com et btmx.io ne routent plus depuis le 21 mai 2021
AscendEX a changé de nom (anciennement BitMax) en mars 2021. Les anciens domaines (`bitmax.io`, `btmx.com`, `btmx.io`) ont été définitivement mis hors service le 21 mai 2021 à 15:00 UTC. Les intégrations plus anciennes qui pointent encore vers ces domaines renvoient des erreurs DNS ou de routage. Les nouvelles intégrations doivent cibler les domaines d'AscendEX et sa documentation mise à jour. Les anciens tutoriels et messages de forums concernant BitMax sont toujours visibles sur le web ; considérez-les comme obsolètes et vérifiez les informations par rapport à la documentation actuelle avant de copier du code.
04 · Isolation des risques
Les positions futures isolées limitent le risque de liquidation croisée
Les contrats futures d'AscendEX prennent en charge les marges croisées (cross) et isolées (isolated) par position. Les positions isolées plafonnent la perte à la marge allouée ; une liquidation ne se propage pas au reste du compte ou aux autres positions. Pour les déploiements multi-stratégies où une stratégie implique une position plus importante que les autres, privilégiez la marge isolée : une liquidation isolée se gère proprement sans impacter vos autres positions. Documentez le mode de marge dans votre dépôt afin qu'un redéploiement ne le modifie pas silencieusement.
SourceAscendEX Futures v2 docs05 · Portée des WebSockets
Les abonnements WebSocket privés sont limités à l'objet de compte authentifié
Les canaux WebSocket privés d'AscendEX sont limités à un objet de compte spécifique (cash, margin ou futures). S'abonner à un canal privé avec une clé émise pour un autre objet de compte renvoie une erreur d'abonnement au lieu de changer de portée de manière transparente. Faites correspondre le chemin d'abonnement WebSocket à l'objet de compte pour lequel la clé a été émise, et documentez cette association aux côtés de la clé dans votre manifeste de secrets. Une stratégie futures qui utilise une clé cashAccount pour passer des ordres et un abonnement WebSocket futuresAccount est une source fréquente d'erreur d'association.
Section 06 · Conçu pour
Conçu pour
Les runtimes TradingHost pour AscendEX 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, 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é à AscendEX.
Non. Le code de votre stratégie se connecte à AscendEX 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 d'AscendEX est fourni par AscendEX. Vous êtes responsable de votre compte AscendEX, des autorisations de vos clés API, de vos identifiants et du respect des conditions d'utilisation d'AscendEX.
Non. TradingHost est l'environnement d'exécution cloud (runtime) 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 bots prêts à l'emploi. Avec TradingHost, vous écrivez ou générez vous-même la 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 détiennent la logique de la stratégie ; TradingHost exécute 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 transmission des journaux (logs), la rotation des secrets, le basculement de région et la surveillance de la disponibilité. TradingHost vous offre un environnement d'exécution géré et conçu spécifiquement pour les stratégies de trading : déploiement natif via GitHub, contrôle piloté par MCP depuis vos IDE IA, ainsi que des interfaces de logs et de santé prêtes à l'emploi. Si vous souhaitez gérer l'infrastructure vous-même, AWS convient parfaitement. Si vous préférez un runtime sous forme de service managé, TradingHost est la voie la plus rapide.
Oui. TradingHost exécute les stratégies Python ; choisissez le runtime de framework qui correspond à 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 les marchés au comptant (spot) et de swaps d'AscendEX via la classe unifiée `ascendex`. Intégrez votre stratégie CCXT dans un conteneur, connectez-la à GitHub, et TradingHost l'exécutera comme n'importe quel projet Python ou Node. Consultez le runtime du framework CCXT pour connaître toute la procédure 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 runtime, ou les séparer dans différents runtimes pour plus d'isolation et de clarté opérationnelle. La limitation des clés par objet de compte d'AscendEX s'associe parfaitement au modèle multi-stratégie. Consultez la page du runtime TradingHost pour en savoir plus sur le modèle multi-stratégie.
La méthode la plus rapide consiste à forker un runtime 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 de runtime sont détaillés sur la page des tarifs.
Dans votre flux de travail de 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 AscendEX, votre secret ou votre valeur accountGroup. Consultez la section sur les secrets de la plateforme pour connaître le modèle de gestion complet.
Non. Les stratégies ne devraient jamais avoir besoin d'autorisations de retrait. Utilisez des autorisations limitées (lecture, trading) et excluez totalement les retraits de la clé de stratégie. AscendEX émettant des clés par objet de compte, les parties cash, margin et futures possèdent chacune leur propre surface de clé ; conservez la clé permettant les retraits totalement à part et ne l'intégrez jamais à un runtime de stratégie.
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 (CLI). Les outils d'IA peuvent inspecter les déploiements, examiner les logs, redémarrer les stratégies et gérer les flux de travail du runtime. 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 une présentation complète.
Les deux. L'interface de contrôle MCP fonctionne tout aussi bien depuis des agents en ligne de commande (CLI de Claude Code, 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 vers votre branche principale déclenche un redéploiement.
Le runtime détecte le plantage et expose les logs et les informations de santé pertinentes. 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 risques. Consultez la section observabilité pour en savoir plus sur l'interface de logs et de santé.
Les requêtes privées d'AscendEX sont routées sous `https://ascendex.com/<accountGroup>/api/pro/...`. La valeur `accountGroup` est propre à chaque utilisateur et est renvoyée par le point de terminaison (endpoint) d'informations de compte lors de la première authentification. Si vous avez copié un modèle de départ qui code en dur `accountGroup` avec une valeur connue ou suppose qu'elle est égale à `0`, les requêtes renverront une erreur 404 même si la clé est correcte. Récupérez `accountGroup` au démarrage, mettez-le en cache dans l'environnement du runtime et ne le codez jamais en dur. Consultez la section Notes opérationnelles ci-dessus pour obtenir des instructions complètes.
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 sur l'environnement d'exécution en production et le déploiement. Le backtesting relève de votre environnement de recherche, de votre framework ou d'AlgoBuilder.