Runtime natif IA pour stratégies de trading BitMart
Codez 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 sélection de région.
Section 01 · En un coup d’œil
En un coup d’œil
- Plateforme
- BitMart
- Type de plateforme
- Plateforme d'échange crypto
- Classe d’actifs
- Crypto
- Produits pris en charge
- Spot, isolated margin, futures sur marge USDT et futures inverses via des familles d'endpoints distinctes
- 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
- API natives REST et WebSocket BitMart, 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, health checks, sélection de région, contrôle MCP
- Rôle de BitMart
- Compte d'échange, accès API, accès au marché, lieu d'exécution
- Affiliation
- TradingHost est indépendant et n'est pas affilié à BitMart
Section 02 · Ce que propose BitMart
Ce que propose BitMart
BitMart propose le spot, l'isolated margin ainsi que les futures sur marge USDT et inverses via trois familles d'endpoints distinctes avec leurs propres pools de limites de requêtes. L'authentification utilise une clé API, un secret et une chaîne memo signée avec HMAC-SHA256 ; un memo manquant déclenche une erreur de signature même si le HMAC est correct. Le niveau de KYC détermine le plafond des limites de requêtes. Le trading de futures est restreint aux États-Unis, à Hong Kong SAR et dans plusieurs autres régions ; cette restriction est appliquée lors de la création du compte et de la soumission des ordres. 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 symboles figurent dans la documentation de BitMart.
Marchés et types de stratégies
- Stratégies spot sur les paires USDT et BTC
- Futures perpétuels sur marge USDT (juridictions non restreintes)
- Futures perpétuels inverses (sur marge crypto)
- Stratégies de prêt en isolated margin
- Exécution basée sur les niveaux de KYC avec des limites de requêtes plus élevées
- Déploiements multi-stratégies isolés par sous-comptes
- Consommateurs de flux de transactions et de carnets d'ordres WebSocket
- Exécution multi-familles (spot + futures avec domaines distincts)
Interface API
- Produits couverts
- Spot v3 sur le portail API ouvert, endpoints isolated margin, et futures sur un domaine distinct. Chaque famille possède son propre pool de limites de requêtes et son périmètre d'authentification. Le trading de futures est restreint aux États-Unis, à Hong Kong SAR et dans plusieurs autres régions ; la restriction est appliquée lors de la création du compte et de la soumission des ordres, et pas seulement à la connexion.
- Méthodes de connexion
- REST pour le placement d'ordres et les requêtes de compte. WebSocket pour les données de marché et les événements de compte privés. Les flux WebSocket publics sont ouverts ; les abonnements WebSocket privés sont limités par l'authentification de chaque clé.
- Authentification
- Clé API, secret et memo signés avec HMAC-SHA256 (hexadécimal en minuscules). Les clés sont limitées par famille (spot, margin, futures) et le niveau de KYC détermine le plafond des limites de requêtes. La chaîne memo est spécifique à BitMart et est vérifiée côté serveur ; un memo manquant renvoie une erreur de signature même si le HMAC lui-même est correct.
Pour plus de détails, reportez-vous à BitMart
Les endpoints spécifiques, les poids des limites de requêtes, les listes de symboles, les paliers de frais et l'historique des versions se trouvent dans la documentation de BitMart. Considérez-les comme la source de vérité.
Section 03 · Développer avec l’IA
Développez votre stratégie BitMart 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 BitMart native
Contrôle direct sur le comportement spécifique à BitMart, les données de compte et la logique d'exécution des ordres à travers les trois familles d'endpoints.
CCXT
Interface commune entre BitMart et d'autres plateformes d'échange crypto. CCXT expose les marchés spot et swap de BitMart via la classe unifiée `bitmart`.
Freqtrade ou Hummingbot
Déploiements basés sur des frameworks utilisant leur structure de stratégie et leur modèle de configuration. Les deux intègrent des connecteurs BitMart couvrant principalement le spot.
Connecteur personnalisé
Votre propre moteur de trading interne ou intégration propriétaire BitMart, signant les requêtes avec HMAC-SHA256 en incluant la chaîne memo de BitMart.
Compatibilité des frameworks avec les produits BitMart
La couverture varie selon le framework. CCXT couvre les marchés spot et swap de BitMart ; Freqtrade couvre le spot ; Hummingbot couvre le spot avec un support partiel des contrats perpétuels ; l'accès natif à l'API BitMart couvre tout ce que propose BitMart, y compris l'isolated margin et les familles de futures. La couverture des futures n'est pas disponible pour les comptes situés dans des juridictions restreintes, quel que soit le framework utilisé.
✓ support confirmé selon la doc officielle du framework. « no » indique qu'il n'est pas officiellement documenté comme supporté. « 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
BitMart 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 à BitMart.
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 à BitMart.
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 nécessaires à votre stratégie (clé API BitMart, clé secrète, chaîne memo et d'éventuels flags de portée par famille d'API), puis déployez. TradingHost compile votre conteneur à partir du dépôt et exécute votre stratégie sur une infrastructure Kubernetes managée. Pas besoin d'installer Docker en local.
- É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 BitMart
Les pièges qui vous guettent lorsque vous exécutez réellement une stratégie BitMart dans un runtime cloud conteneurisé, absents de la doc de BitMart ou des fichiers README des frameworks. Chaque affirmation ci-dessous est citée ou paraphrasée de la propre documentation de BitMart ; les conseils liés au déploiement proviennent de l'exécution de ces stratégies sur TradingHost.
01 · Trois familles
Spot v3, Margin et Futures résident derrière des familles d'endpoints distinctes
L'interface REST de BitMart se divise en trois familles : Spot v3 sur le portail API ouvert, les endpoints Margin isolés, et les Futures sur un domaine distinct. Chaque famille possède son propre pool de limites de requêtes, son propre périmètre d'authentification et son propre vocabulaire d'erreurs. Une stratégie qui interagit à la fois avec le spot et les futures doit gérer son budget de requêtes par rapport aux pools de chaque famille plutôt qu'à un plafond unique combiné ; des tentatives de reconnexion multi-familles ignorant cette séparation risquent de saturer un côté alors que l'autre dispose encore de marge.
02 · Memo de signature
La chaîne memo de l'API fait partie de la signature, ce n'est pas un simple label
Le protocole de signature HMAC-SHA256 de BitMart intègre la chaîne memo de l'API aux côtés de la clé et du secret. Ce memo est défini lors de la création de la clé et est vérifié côté serveur à chaque requête signée. Une erreur silencieuse courante consiste à traiter le memo comme une simple étiquette d'interface utilisateur et à l'exclure de la charge utile de la signature ; la requête renvoie alors une erreur de signature, même si le calcul HMAC est par ailleurs correct. Stockez le memo dans le même emplacement de secrets que la clé et le secret, et configurez le code client pour qu'il refuse de signer si le memo est absent.
03 · Géographie Futures
Les contrats futures sont restreints aux États-Unis, à Hong Kong SAR et dans d'autres régions
BitMart restreint le trading de futures aux États-Unis, à Hong Kong SAR et dans plusieurs autres régions. Cette restriction est appliquée lors de la création du compte et de la soumission des ordres. Ainsi, un ordre de futures provenant d'un compte domicilié dans une juridiction restreinte sera rejeté, quels que soient le niveau de la clé ou le statut KYC. Si votre stratégie s'exécute sur plusieurs juridictions, configurez la sélection de la plateforme ou de la région comme une variable de configuration de premier ordre plutôt que comme un simple paramètre par clé, et laissez la stratégie contourner BitMart lorsque la juridiction d'exécution figure sur la liste des restrictions.
SourceBitMart support center04 · Niveaux de KYC
Le niveau de KYC détermine le plafond des limites de requêtes et la capacité de retrait
L'accès à l'API dépend du niveau de KYC du compte : un niveau supérieur débloque des limites de requêtes (rate limits) plus élevées et des quotas de retrait accrus. Une stratégie qui s'exécute sans problème sur un compte vérifié peut rencontrer des erreurs 429 inattendues lorsqu'elle est déployée sur un nouveau compte de niveau inférieur. Vérifiez que le compte d'exécution dispose du même niveau de KYC que celui de production avant de calibrer le débit de votre stratégie, et soumettez tout taux d'envoi par seconde à une configuration par compte plutôt qu'à une constante codée en dur.
SourceBitMart support center05 · Posture post-incident
Renouvelez les clés antérieures à l'incident de sécurité de décembre 2021
BitMart a divulgué un incident de sécurité en décembre 2021, au cours duquel environ 196 millions de dollars ont été dérobés dans des hot wallets. La plateforme a par la suite restructuré l'émission des clés et les contrôles de vérification des sous-comptes. Si vous détenez une clé API BitMart émise avant cette période et que vous ne l'avez pas renouvelée depuis, considérez-la comme compromise et générez-en une nouvelle. Le protocole de signature reste inchangé ; cette mesure d'hygiène opérationnelle vise simplement à renouveler toute clé antérieure à la mise en place de la nouvelle posture de sécurité.
Section 06 · Conçu pour
Conçu pour
Les runtimes TradingHost pour BitMart 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 passant d'un hébergement VPS à 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é à BitMart.
Non. Le code de votre stratégie se connecte à BitMart 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) dans lequel ce code s'exécute.
Non. L'accès à l'API de BitMart est fourni par BitMart. Vous êtes responsable de votre compte BitMart, des autorisations de votre API, de vos identifiants et du respect des conditions d'utilisation de BitMart.
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 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 contente 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 du système d'exploitation, l'orchestration des conteneurs, la transmission des journaux (logs), la rotation des secrets, le basculement régional et la surveillance de la disponibilité. TradingHost vous offre un environnement d'exécution géré, 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 suivi d'état prêtes à l'emploi. Si vous préférez gérer l'infrastructure vous-même, AWS convient parfaitement. Si vous souhaitez un environnement d'exécution sous forme de service managé, TradingHost est la voie la plus directe.
Oui. TradingHost exécute les stratégies Python ; choisissez l'environnement d'exécution de framework qui correspond à votre pile technique 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 spot et swap de BitMart via la classe unifiée `bitmart`. Intégrez votre stratégie CCXT dans un conteneur, liez-la à GitHub, et TradingHost l'exécutera comme n'importe quel autre projet Python ou Node. Consultez l'environnement d'exécution du framework CCXT pour connaître tous 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 des raisons d'isolation et de clarté opérationnelle. 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 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 détenir votre clé API, votre secret ou votre chaîne memo BitMart. Consultez la section sur les secrets de la plateforme pour connaître l'intégralité du modèle de gestion.
Non. Les stratégies ne devraient jamais nécessiter d'autorisations de retrait. Utilisez des autorisations restreintes (lecture, trading spot, trading de futures) et désactivez les retraits pour la clé de la stratégie. Générez des clés distinctes, gérées manuellement, pour les transferts et les tâches opérationnelles.
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, 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 canal 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 tout aussi bien à partir d'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.
L'environnement d'exécution détecte le plantage et affiche les logs ainsi que les informations d'état correspondantes. Lorsque cela est possible, 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 des logs et de suivi d'état.
BitMart applique les restrictions sur les futures au niveau de la juridiction, et non uniquement au niveau de la clé. Les États-Unis, Hong Kong SAR et plusieurs autres régions sont bloqués pour les futures BitMart, quel que soit le champ d'application de la clé. Si votre compte a été créé dans une juridiction restreinte, les ordres de futures renverront un rejet régional et aucune modification de clé ne pourra les débloquer. Redirigez vos flux de futures vers une plateforme non restreinte, ou utilisez BitMart uniquement pour le spot depuis ce compte. 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 le runtime de production et le déploiement. Le backtesting relève de votre environnement de recherche, de votre framework ou d'AlgoBuilder.