Runtime natif IA pour stratégies de trading Mercado Bitcoin
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 de premier ordre, logs et exécution native en BRL.
Section 01 · En un coup d’œil
En un coup d’œil
- Plateforme
- Mercado Bitcoin
- Type de plateforme
- Plateforme d'échange crypto (basée au Brésil, plus grande plateforme d'actifs numériques d'Amérique latine)
- Classe d’actifs
- Crypto, titres à revenu fixe tokenisés et actifs réels (RWA) réglementés au Brésil
- Produits pris en charge
- Trading au comptant (spot), actifs tokenisés (actifs financiers réglementés sur XRP Ledger, y compris titres à revenu fixe), staking sur NEAR, ADA, SOL, ETH, CHZ. Stablecoin MBRL indexé sur le BRL émis sur TRON (nov. 2024). Pas de produits dérivés crypto ou de contrats perpétuels grand public.
- Modèle d’exécution
- Runtime de stratégie conteneurisé
- Source de déploiement
- GitHub
- Langages
- Tout langage compatible avec l'exécution en conteneur
- Intégrations courantes
- API native Mercado Bitcoin v4 (REST), Mercado Bitcoin WebSocket v0, TAPI v3 historique, CCXT (`mercado`), sur mesure
- 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é (health checks), sélection de région, contrôle MCP
- Rôle de Mercado Bitcoin
- Compte d'échange, accès API, accès au marché, lieu d'exécution, passerelles fiduciaires BRL via PIX, garde (custody)
- Affiliation
- TradingHost est indépendant et n'est pas affilié à Mercado Bitcoin ni à sa maison mère 2TM Participações. Mercado Bitcoin opère sous la loi brésilienne sur les actifs virtuels (Lei 14.478/2022) et le cadre SPSAV du Banco Central do Brasil (Resolutions 519, 520 et 521 de novembre 2025).
Section 02 · Ce que propose Mercado Bitcoin
Ce que propose Mercado Bitcoin
Mercado Bitcoin est la plus grande plateforme d'actifs numériques d'Amérique latine, nativement intégrée au BRL avec PIX comme passerelle fiduciaire principale. Les stratégies accèdent à la plateforme via REST et WebSocket sur l'actuelle API v4 (flux d'autorisation puis jeton), ou via la TAPI v3 historique (chemins signés par HMAC-SHA512). Au-delà du spot crypto, MB propose un programme réglementé d'actifs réels (RWA) tokenisés sur XRPL et le stablecoin MBRL indexé sur le BRL émis sur TRON ; il n'existe pas de produits dérivés crypto ou de contrats perpétuels grand public.
Marchés et types de stratégies
- Grille spot BRL
- DCA financé par PIX
- Arbitrage triangulaire BRL/USDT
- Exécution à faible latence au Brésil et en Amérique latine
- Paires de stablecoins MBRL et BRZ
- Rééquilibrage de titres à revenu fixe tokenisés (liés au Tesouro, RWA sur XRPL)
- Rééquilibrage de portefeuille
- Market-making
Interface API
- Produits couverts
- Spot, actifs tokenisés (interface client). Pas de sandbox publique mentionnée dans la documentation développeur de MB ; considérez l'environnement comme uniquement de production et effectuez vos tests via le mode dry-run de TradingHost.
- Méthodes de connexion
- REST sur `https://api.mercadobitcoin.net/api/v4` (actuelle). WebSocket sur `wss://ws.mercadobitcoin.net/ws/v4` documenté sur `https://ws.mercadobitcoin.net/docs/v0/`.
- Authentification
- La nouvelle API v4 utilise un flux d'autorisation par jeton (POST `/authorize` avec clé API + secret, puis en-tête de type bearer token sur les endpoints privés). La TAPI v3 historique utilise HMAC-SHA512 avec les en-têtes `TAPI-ID` / `TAPI-MAC` signant les chemins de requête `/tapi/v3/`. La nouvelle v4 remplace la TAPI pour les nouvelles intégrations. PIX est la passerelle fiduciaire, gérée par MB Pay (la branche d'établissement de paiement), et non par l'API de trading.
Pour plus de détails, reportez-vous à Mercado Bitcoin
Les endpoints spécifiques, les poids des limites de taux (rate limits), les listes de symboles et les paliers de frais figurent dans la documentation de Mercado Bitcoin. Référez-vous-y comme source unique de vérité.
Section 03 · Développer avec l’IA
Développez votre stratégie Mercado Bitcoin 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 Mercado Bitcoin
Contrôle direct du comportement spécifique à Mercado Bitcoin, des données de compte et de la logique d'exécution des ordres via l'actuelle API REST v4 (autorisation puis jeton) ou la TAPI v3 historique (chemins signés par HMAC-SHA512).
CCXT
Interface commune entre Mercado Bitcoin et d'autres plateformes d'échange crypto, exposée sous l'identifiant d'échange `mercado`.
Freqtrade
Déploiements basés sur le framework Freqtrade en utilisant sa structure de stratégie. Le support de Mercado Bitcoin est disponible via CCXT au niveau communautaire ; prévoyez de valider les métadonnées de marché et les types d'ordres par rapport à MB avant de passer en production.
Connecteur sur mesure
Votre propre moteur de trading interne ou intégration propriétaire Mercado Bitcoin, y compris des consommateurs WebSocket directs pour des stratégies spot BRL à faible latence.
Prise en charge des frameworks pour Mercado Bitcoin
Cette matrice uniquement spot correspond à la gamme de produits de Mercado Bitcoin : il n'y a pas de colonne USD-M, COIN-M ou options à remplir. Si votre stratégie nécessite des contrats perpétuels ou des futures sur marge USD, associez Mercado Bitcoin à une autre plateforme (par exemple Binance, Bybit ou OKX) pour la partie dérivés. Le programme d'actifs réels tokenisés de MB (séries réglementées basées sur XRPL, jetons liés à des titres à revenu fixe) se situe en dehors de l'interface standard des paires crypto programmatiques et est exclu de cette matrice pour le moment.
✓ support confirmé selon la documentation officielle du framework. « partial » indique un support de niveau communautaire pouvant nécessiter une validation supplémentaire. « no connector » indique que le framework ne fournit pas de connecteur Mercado Bitcoin. Les liens de workflow pointent 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
Mercado Bitcoin 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 à Mercado Bitcoin.
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 à Mercado Bitcoin.
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
Pointez TradingHost vers votre dépôt de stratégie existant, ou dupliquez (fork) un runtime de framework TradingHost (CCXT ou Freqtrade) 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 de l'API v4 de Mercado Bitcoin gèrent le flux d'autorisation puis d'obtention de jeton : votre clé API et votre secret servent à envoyer une requête POST à `/authorize`, et le jeton bearer renvoyé est transmis aux endpoints privés suivants), 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 Mercado Bitcoin
Les pièges qui vous guettent lorsque vous exécutez réellement une stratégie Mercado Bitcoin dans un runtime cloud conteneurisé, absents de la documentation de Mercado Bitcoin ou des fichiers README des frameworks. Chaque affirmation ci-dessous est citée ou paraphrasée de la propre documentation de Mercado Bitcoin et des registres réglementaires brésiliens publiés ; les conseils liés au déploiement proviennent de l'exécution de ces stratégies sur TradingHost.
01 · Générations d'API
Deux interfaces API parallèles, la v4 est la voie à suivre
La TAPI v3 historique réside sur `/tapi/v3/` et utilise HMAC-SHA512 sur le chemin de requête avec les en-têtes `TAPI-ID` et `TAPI-MAC`. L'actuelle API v4 sur `api.mercadobitcoin.net/api/v4` utilise un modèle d'autorisation puis jeton. Développez vos nouvelles stratégies sur la v4 ; n'utilisez la TAPI qu'en dernier recours pour les endpoints non encore portés.
02 · Réseau PIX
Les paiements instantanés brésiliens gèrent le financement en BRL
Les dépôts et retraits en BRL utilisent PIX, le réseau de paiement instantané du Banco Central do Brasil. La compensation PIX fonctionne 24h/24, 7j/7, 365 jours par an, y compris les week-ends et jours fériés. Les dépôts via PIX apparaissent sur les comptes MB de manière quasi instantanée ; les retraits en BRL sont traités sous 1 jour ouvré selon les conditions publiées par MB. PIX est géré en dehors de l'API de trading.
03 · Niveaux de KYC
Les comptes vérifiés débloquent les limites d'automatisation
Les comptes non vérifiés sont limités à 1 000 R$ de retrait par 24h et 50 000 R$ de dépôt annuel. Les comptes entièrement vérifiés (CPF et identité) débloquent des retraits quotidiens de 50 000 R$ sans plafond de dépôt. Le niveau de KYC affecte directement ce qu'une stratégie automatisée peut exécuter.
04 · Actifs tokenisés
Les séries RWA s'échangent selon leur propre structure de marché
Les paires crypto au comptant (spot) s'échangent 24h/24 et 7j/7. Les actifs tokenisés réglementés (le programme RWA sur XRPL de MB, les tokens liés à des produits à taux fixe) suivent le comportement de l'actif sous-jacent et peuvent présenter des contraintes de règlement ; ne supposez pas une découverte continue des prix sur les séries tokenisées comme vous le feriez pour le BTC/BRL.
05 · Réglementation
Lei 14.478/2022, résolutions SPSAV, surveillance de la CVM
MB opère sous la loi brésilienne sur les actifs virtuels (Lei 14.478/2022). Le 10 novembre 2025, le Banco Central do Brasil a publié les Resolutions 519, 520 and 521 établissant le cadre de la SPSAV (sociedade prestadora de serviços de ativos virtuais). Les plateformes doivent obtenir l'autorisation de la SPSAV, respecter un capital social minimum (1 million de R$ pour les intermédiaires, 2 millions de R$ pour les dépositaires, 3 millions de R$ pour les courtiers), et la CVM conserve sa compétence sur les actifs tokenisés qualifiés de valeurs mobilières. Impact opérationnel sur les stratégies : attendez-vous à des re-vérifications KYC périodiques et à des demandes de justificatifs d'origine des fonds sur les flux PIX importants.
Section 06 · Conçu pour
Conçu pour
Les runtimes TradingHost pour Mercado Bitcoin sont particulièrement adaptés aux :
- Développeurs quantitatifs brésiliens et d'Amérique latine (LATAM) concevant des stratégies natives en BRL
- Desks fintech et crypto gérant des carnets d'ordres spot en BRL en production via le réseau PIX
- Développeurs axés sur les IDE IA utilisant Cursor et Claude Code pour déployer des stratégies sur une plateforme d'exécution brésilienne
- Équipes d'actifs tokenisés et de RWA utilisant la suite de tokenisation réglementée de MB
- Équipes d'arbitrage de stablecoins et de devises (FX) négociant du MBRL, BRZ, USDT, USDC sur des paires en BRL
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é à Mercado Bitcoin ni à sa maison mère 2TM Participações.
Non. Le code de votre stratégie se connecte à Mercado Bitcoin 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 Mercado Bitcoin est fourni par Mercado Bitcoin. Vous êtes responsable de votre compte Mercado Bitcoin, des autorisations de vos API, de vos identifiants et du respect des conditions d'utilisation de Mercado Bitcoin.
Non. TradingHost est l'environnement d'exécution (runtime) cloud dans lequel 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 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 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 de l'OS, l'orchestration des conteneurs, la centralisation 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 (runtime) 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 runtime sous forme de service managé, TradingHost est la voie la plus rapide.
Oui. TradingHost exécute des stratégies en Python ; choisissez le runtime de framework qui correspond à votre pile technique ou déployez votre propre dépôt (repo).
Oui. TradingHost prend en charge n'importe quel langage capable de s'exécuter dans un conteneur.
Oui. L'identifiant de la plateforme est mercado. Il expose les marchés spot de MB via l'interface unifiée standard de CCXT. Si vous utilisez Freqtrade ou tout autre framework basé sur CCXT sur TradingHost, définissez le nom de la plateforme sur mercado. Il n'existe pas de connecteur Hummingbot officiel ; cette option nécessite un connecteur personnalisé. Consultez le runtime 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 runtime, ou les séparer dans différents runtimes pour des raisons d'isolation et de clarté opérationnelle. Consultez la page du runtime TradingHost pour en savoir plus sur le modèle multi-stratégie.
La méthode la plus rapide consiste à dupliquer (fork) un runtime de framework TradingHost : CCXT pour un projet prêt à être déployé, ou à connecter votre propre dépôt de stratégie GitHub. Associer un dépôt GitHub et créer une stratégie est gratuit ; les forfaits 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 du dépôt GitHub, les secrets d'environnement ou votre propre processus de gestion des secrets approuvé. TradingHost n'a pas besoin de conserver vos clés d'API et secrets. 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 la portée minimale requise (lecture et trading) et activez toute restriction d'IP (whitelisting) proposée par Mercado Bitcoin sur votre clé. Les clés permettant les retraits doivent être réservées aux comptes que vous gérez manuellement depuis un hôte fixe.
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 une vue d'ensemble.
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. La boucle de déploiement native de 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 d'état de santé correspondantes. 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 d'état de santé.
Vérifiez quelle génération d'API vous appelez. La nouvelle API /api/v4 utilise un flux /authorize qui émet un jeton (token) envoyé lors des requêtes privées ultérieures ; l'ancienne TAPI /tapi/v3/ utilise HMAC-SHA512 sur le chemin de la requête avec les en-têtes TAPI-ID et TAPI-MAC. Mélanger les deux est la cause la plus fréquente d'erreur. Vérifiez également que l'horloge de votre serveur est synchronisée et que la clé d'API est activée pour l'opération (lecture, trading, retrait) que vous appelez.
Oui. L'alimentation en BRL est gérée par l'intégration PIX de MB, en dehors de l'API de trading. PIX fonctionne 24h/24 et 7j/7 sur l'ensemble du système bancaire brésilien, de sorte que les dépôts sont généralement crédités instantanément. Une fois les BRL sur votre compte MB, les stratégies exécutées dans un conteneur TradingHost appellent l'API v4 de MB pour passer des ordres sur les paires en BRL. TradingHost ne touche ni à PIX ni à vos identifiants bancaires.
MB opère sous le régime de la loi brésilienne sur les actifs virtuels (Lei 14.478/2022). Les résolutions SPSAV de novembre 2025 (519, 520 et 521) du Banco Central do Brasil définissent l'octroi de licences pour les prestataires de services d'actifs virtuels, et la CVM supervise les actifs tokenisés qualifiés de valeurs mobilières. Un KYC complet est requis pour le trading en production ; les limites de retrait sont liées au niveau de vérification ; les endpoints d'actifs tokenisés peuvent appliquer des règles d'adéquation ou d'éligibilité. Rien de tout cela n'affecte la façon dont votre code s'exécute dans un conteneur TradingHost ; cela affecte uniquement ce que le compte MB associé à la clé API est autorisé à faire.
Pour un accès programmatique, vérifiez au moment de l'exécution quelles séries sont exposées via l'endpoint des marchés de l'API v4. Les règles de la CVM peuvent restreindre l'accès à certains instruments. Le MBRL, le stablecoin de MB indexé sur le BRL et émis sur TRON (lancé en novembre 2024), est négociable sur le carnet d'ordres de MB et constitue une contrepartie en espèces naturelle pour l'automatisation côté BRL. Traisez les séries RWA de titres de créance tokenisés sur XRPL comme des instruments distincts avec leur propre structure de marché, plutôt que comme des paires crypto disponibles 24h/24 et 7j/7.
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. Pour Mercado Bitcoin spécifiquement, la région US-East offre généralement une latence aller-retour plus faible vers les endpoints cloud de la région de São Paulo que la région EU. Consultez la page des régions pour obtenir des 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.