Runtime natif IA pour stratégies de trading BitMEX
Développez dans Cursor, Claude Code ou n'importe quel IDE IA. Déployez depuis GitHub vers un runtime cloud managé avec contrôle MCP natif, logs et sélection de la région.
Section 01 · En un coup d’œil
En un coup d’œil
- Plateforme
- BitMEX
- Type de plateforme
- Plateforme d'échange crypto (pionnier des contrats perpétuels)
- Classe d’actifs
- Dérivés crypto (swaps perpétuels et dated futures)
- Produits pris en charge
- inverse perpetual XBTUSD (chaque contrat représente 1 USD de notionnel), swaps perpétuels libellés en USDT et BTC, dated futures, contrats de type prediction-market sur une sélection de sous-jacents. Testnet disponible sur testnet.bitmex.com. Les utilisateurs américains sont bloqués par IP geolocation au niveau des clés API.
- 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 et WebSocket natifs BitMEX, CCXT, 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, choix de la région, contrôle MCP
- Rôle de BitMEX
- Compte de trading, accès API, accès au marché, lieu d'exécution
- Affiliation
- TradingHost est indépendant et n'est pas affilié à BitMEX.
Section 02 · Ce que propose BitMEX
Ce que propose BitMEX
BitMEX a inventé le swap perpétuel crypto et reste une plateforme exclusivement dédiée aux dérivés. XBTUSD est son contrat phare de type inverse perpetual, chaque contrat valant 1 USD de notionnel et étant réglé en Bitcoin. Les perpétuels libellés en USDT et BTC ainsi que les dated futures complètent l'offre. Toutes les quantités de Bitcoin sont exprimées en XBt (satoshis) et toutes les quantités de USD en USDt ; une conversion côté client est requise. Les spécificités des endpoints évoluent avec le temps. La structure globale reste stable ; les spécifications précises des contrats, les limites de taux (rate-limit weights) et les paliers de frais (fee tiers) sont détaillés dans la documentation de BitMEX.
Marchés et types de stratégies
- Market making sur l'inverse perpetual XBTUSD
- Stratégies de swap perpétuel libellé en BTC
- Stratégies de swap perpétuel libellé en USDT
- Trading de base et de spreads calendaires sur dated futures
- Carry de funding rate sur les contrats inverse perpetuals
- Déploiements validés sur testnet avant le passage sur le mainnet
- Flux d'ordres et de positions via les canaux privés WebSocket
- Arbitrage multi-plateformes combiné avec des marchés spot ou dérivés hors BitMEX
Interface API
- Produits couverts
- Swaps perpétuels (inverse XBTUSD, libellés en USDT, libellés en BTC), dated futures, et contrats de type prediction-market sur sous-jacents sélectionnés. Le testnet sur testnet.bitmex.com réplique l'API de production avec des clés et des soldes distincts.
- Méthodes de connexion
- REST sur https://www.bitmex.com/api/v1 pour le passage d'ordres et les requêtes de compte. Flux WebSocket pour les données de marché en temps réel, le carnet d'ordres (depth) et les transactions. Canaux privés WebSocket pour les événements de compte, de position et d'ordre.
- Authentification
- Clé API permanente et secret par stratégie. Les requêtes privées sont signées avec HMAC-SHA256 sur verb + path + nonce + body. Le nonce peut être soit un timestamp microseconde Unix-epoch, soit une valeur d'en-tête api-expires. Les utilisateurs américains sont bloqués par IP geolocation au niveau des clés API ; la création de clé réussit mais les endpoints de trading refusent l'accès.
- Dénomination
- Tous les montants en Bitcoin sont exprimés en XBt (satoshis, 1 XBt = 0.00000001 XBT). Tous les montants en USD sont exprimés en USDt (1 USDt = 0.000001 USDT). Les contrats perpétuels XBTUSD ont un notionnel de 1 USD chacun et sont réglés en Bitcoin. Une conversion côté client est requise pour afficher ou calculer les valeurs dans les unités standards BTC ou USD.
Pour plus de détails, reportez-vous à BitMEX
Les endpoints spécifiques, les spécifications des contrats, les limites de taux (rate-limit weights), les paliers de frais (fee tiers) et l'historique des versions sont disponibles dans la documentation de BitMEX. Considérez-les comme la source de vérité unique.
Section 03 · Développer avec l’IA
Développez votre stratégie BitMEX 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 BitMEX native
Contrôle direct du comportement spécifique à BitMEX, des dénominations en XBt et USDt, et de la logique d'exécution des ordres.
Hummingbot
Déploiements basés sur le framework Hummingbot, utilisant sa structure de stratégie et son modèle de configuration.
Connecteur personnalisé
Votre propre moteur de trading interne ou intégration propriétaire BitMEX.
Compatibilité des frameworks avec les produits BitMEX
BitMEX est une plateforme exclusivement dédiée aux dérivés : pas de colonne spot dans la matrice. CCXT expose les perpétuels et les dated futures via la classe unifiée bitmex ; Hummingbot gère les swaps perpétuels via bitmex_perpetual ; Freqtrade ne liste pas BitMEX parmi les plateformes d'échange prises en charge. L'accès natif à l'API BitMEX permet d'atteindre tous les contrats listés par BitMEX.
✓ 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
BitMEX 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 à BitMEX.
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 à BitMEX.
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
Connectez TradingHost à votre dépôt de stratégie existant, ou dupliquez (fork) un runtime de framework TradingHost (CCXT 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 et secret BitMEX, etc.), 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 BitMEX
Les pièges qui vous guettent lorsque vous exécutez réellement une stratégie BitMEX dans un runtime cloud conteneurisé, absents de la documentation de BitMEX ou des fichiers README des frameworks. Chaque point ci-dessous est cité ou paraphrasé de la documentation officielle de BitMEX ; les conseils de déploiement sont issus de l'exploitation de ces stratégies sur TradingHost.
01 · Dénomination en XBt
Tous les montants en Bitcoin sont en satoshis (1 XBt = 0.00000001 XBT) ; le USD en USDt (1 USDt = 0.000001 USDT)
Les réponses de l'API BitMEX utilisent des dénominations non standards. Les soldes en Bitcoin, les champs walletBalance, la marge de position et les valeurs notionnelles des ordres sont tous exprimés en XBt (satoshis), et non en XBT. Les montants libellés en USD sont en USDt, soit six décimales en dessous de l'USDT. Les stratégies qui affichent ou calculent des positions dans des unités utilisateur doivent effectuer la conversion côté client. Le bug de mise en production le plus fréquent est une stratégie qui vise à dimensionner une position de 0,1 BTC et se retrouve à dimensionner 0,1 XBt parce que la conversion a été oubliée.
SourceBitMEX API overview02 · Contrat XBTUSD
Chaque contrat perpétuel XBTUSD a un notionnel de 1 USD, réglé en Bitcoin (inverse)
XBTUSD est un inverse perpetual : chaque contrat représente une exposition notionnelle de 1 USD, avec un PnL et une marge réglés en Bitcoin. Les calculs du prix de liquidation se font en USD. Cela diffère d'un perp linéaire margé en USDT, où la taille du contrat varie selon la quantité de l'actif sous-jacent. Les stratégies qui combinent plusieurs plateformes doivent intégrer le multiplicateur de contrat et la devise de règlement par instrument, plutôt que de supposer une structure unique pour l'ensemble du carnet.
SourceBitMEX API overview03 · Restriction géographique US
Les utilisateurs américains sont bloqués par géolocalisation IP au niveau des clés API
BitMEX interdit les traders basés aux États-Unis. Cette restriction est appliquée au niveau de la clé API par IP geolocation : une clé dont le trafic récent est géolocalisé aux États-Unis verra l'accès aux points d'accès privés refusé, quel que soit le statut de vérification du compte. Un runtime TradingHost dans la région US-East avec une sortie réseau (egress) aux États-Unis sera bloqué pour le trading sur BitMEX. Choisissez une région TradingHost dont la géographie de sortie est conforme aux conditions d'utilisation de BitMEX et à vos propres exigences de conformité.
SourceBitMEX API overview04 · Signature des nonces
Signature HMAC-SHA256 sur verb + path + nonce + body ; api-expires est préférable au nonce brut
Les signatures REST de BitMEX sont un HMAC-SHA256 de la concaténation verb + path + nonce + body, signé avec votre secret. Le nonce peut être soit un timestamp Unix en microsecondes, soit, de préférence, un en-tête api-expires qui attribue à la requête un timestamp d'expiration futur. L'utilisation d'api-expires évite l'exigence stricte de nonce monotone et s'avère plus robuste face aux décalages d'horloge entre conteneurs. La plupart des SDK BitMEX utilisent api-expires par défaut ; vérifiez le vôtre et figez ce paramètre.
SourceBitMEX API overview05 · Clés permanentes
Les clés API sont permanentes jusqu'à leur révocation manuelle ; les clés testnet sont isolées
Les clés API BitMEX n'expirent pas automatiquement. Leur rotation relève d'une responsabilité manuelle : renouvelez vos clés périodiquement plutôt que de compter sur une expiration automatique de la plateforme. Le testnet sur testnet.bitmex.com génère des clés distinctes, détient des soldes séparés et dessert des endpoints différents. Une erreur d'authentification silencieuse courante consiste à déployer en production du code validé sur le testnet sans remplacer le jeu de clés, ou inversement. Conservez les secrets de testnet et de production dans des entrées de Secrets TradingHost distinctes ; ne les réutilisez jamais d'un environnement à l'autre.
06 · Limites de requêtes
Limite de requêtes REST par minute sur les endpoints privés ; WebSocket est fortement recommandé pour les boucles rapides
BitMEX limite le débit des requêtes sur les endpoints REST privés sur une fenêtre d'une minute. Pour les stratégies actives, le modèle recommandé consiste à alimenter les données de marché et l'état du compte via des abonnements WebSocket, et à n'utiliser REST que pour les actions impossibles via WebSocket (passation d'ordres, annulations). Interroger REST en boucle continue pour obtenir les mises à jour du carnet d'ordres ou l'état des positions épuisera votre quota et générera des erreurs 429.
SourceBitMEX API overview
Section 06 · Conçu pour
Conçu pour
Les runtimes TradingHost pour BitMEX 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 et Hummingbot
- Desks spécialisés en dérivés et market makers de contrats perpétuels
- É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é à BitMEX.
Non. Le code de votre stratégie se connecte à BitMEX 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 BitMEX est fourni par BitMEX. Vous êtes responsable de votre compte BitMEX, des autorisations d'API, de vos identifiants et du respect des conditions d'utilisation de BitMEX.
Non. TradingHost est l'environnement d'exécution (runtime) 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 bots préconfigurés. 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 runtime managé 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 souhaitez gérer l'infrastructure vous-même, AWS convient. 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 BitMEX via la classe unifiée `bitmex`, couvrant les contrats perpétuels et les dated futures. Il n'y a aucun produit spot à prendre en charge. Consultez le runtime du framework CCXT pour connaître toute la procédure de configuration.
Non. BitMEX interdit les traders basés aux États-Unis. Cette restriction est appliquée au niveau de la clé API par IP geolocation : une clé dont le trafic récent est géolocalisé aux États-Unis verra l'accès aux points d'accès privés refusé, quel que soit le statut de vérification du compte. Un runtime TradingHost dans la région US-East avec une sortie réseau (egress) aux États-Unis sera bloqué pour le trading sur BitMEX. Choisissez une région TradingHost dont la géographie de sortie est conforme aux conditions d'utilisation de BitMEX et à vos propres exigences de conformité.
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. Consultez la page des runtimes TradingHost pour découvrir le modèle multi-stratégie.
La voie la plus rapide consiste à forker un runtime de framework TradingHost : CCXT ou Hummingbot pour 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 détenir vos clés API et secrets BitMEX. 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 restreintes (ordres, lecture de compte) et effectuez la rotation de vos clés manuellement, car les clés BitMEX n'expirent pas automatiquement.
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 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 en savoir plus.
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 ainsi que les informations de santé pertinentes. 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 risque. Consultez la section observabilité pour accéder aux logs et à l'état de santé du système.
BitMEX libelle tous les montants en Bitcoin en XBt (satoshis). 1 XBt = 0,00000001 XBT, donc un solde affiché de 100 000 000 XBt équivaut à 1 BTC. Les montants en USD sont exprimés en USDt, soit six décimales de moins que l'USDT. Le bug le plus fréquent lors de la mise en production est une stratégie configurée pour dimensionner ses positions en BTC mais qui le fait en XBt par oubli de la conversion. Les contrats inverse perpetual XBTUSD ont une valeur nominale de 1 USD chacun et sont réglés en Bitcoin. Consultez la section Notes opérationnelles ci-dessus pour obtenir les directives complètes.
TradingHost est disponible dans les régions EU et US-East. Choisissez la région la plus proche du moteur d'appariement (matching engine) 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 le runtime de production et le déploiement. Le backtesting relève de votre environnement de recherche, de votre framework ou d'AlgoBuilder.