Runtime natif IA pour stratégies de trading Bitso
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 exécution locale en Amérique latine.
Section 01 · En un coup d’œil
En un coup d’œil
- Plateforme
- Bitso
- Type de plateforme
- Exchange crypto (hub Amérique latine)
- Classe d’actifs
- Crypto
- Produits pris en charge
- Spot uniquement. Marge mentionnée comme en cours de développement dans la doc ; pas de futures ni de perpétuels.
- 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
- REST et WebSocket natifs Bitso, CCXT (`bitso`), sur mesure
- Intégration du workflow d’IA
- Interface de contrôle MCP
- Rôle de TradingHost
- Runtime, déploiement, logs, health checks, sélection de région, contrôle MCP
- Rôle de Bitso
- Compte d'exchange, accès API, accès au marché, lieu d'exécution, passerelles fiat MXN/BRL/ARS (SPEI, PIX)
- Affiliation
- TradingHost est indépendant et n'est pas affilié à Bitso. Bitso opère sous la Ley Fintech du Mexique (sous la surveillance de la CNBV), est enregistré auprès de la CNV argentine en tant que PSAV no. 51 (depuis le 19 juillet 2024), et détient une licence de la GFSC de Gibraltar pour les services institutionnels d'actifs virtuels.
Section 02 · Ce que propose Bitso
Ce que propose Bitso
Bitso est un exchange spot uniquement, basé en Amérique latine, disposant de passerelles fiat MXN, BRL et ARS (SPEI au Mexique, PIX au Brésil, CBU/Alias locaux en Argentine). Les stratégies communiquent avec la plateforme via REST et WebSocket, authentifiées par un en-tête unique `Authorization: Bitso <key>:<nonce>:<sig>` signé par HMAC-SHA256. Il n'y a pas de produits dérivés, de perpétuels ni d'options ; la marge est uniquement mentionnée dans la documentation comme étant en cours de développement.
Marchés et types de stratégies
- Arbitrage de stablecoins MXN/USD (spreads USDT_MXN, USDC_MXN)
- Exécution sur paires BRL (capture de liquidité BTC_BRL, ETH_BRL)
- Capture de markup ARS (routage de prime peso-stablecoin)
- Rotation spot USDC/USDT sur les carnets d'ordres d'Amérique latine
- Rééquilibrage de portefeuille multi-pays d'Amérique latine (MXN, BRL, ARS, COP)
- Stratégies de desk stablecoin financées par SPEI/PIX
- Market making BTC_MXN avec streaming du top 20 du carnet d'ordres
- Couverture d'inventaire pour corridors de transfert de fonds (flux Mexique vers États-Unis)
Interface API
- Produits couverts
- Spot. Sandbox à l'adresse `https://api-sandbox.bitso.com/api/v3/` (utilise le testnet BTC ainsi que le testnet Ethereum pour les dépôts).
- Méthodes de connexion
- REST à l'adresse `https://api.bitso.com/api/v3/`. WebSocket à l'adresse `wss://ws.bitso.com` avec les canaux `trades`, `orders` et `diff-orders`.
- Authentification
- HMAC-SHA256. En-tête `Authorization` unique sous la forme littérale `Bitso <key>:<nonce>:<signature>`. La signature est un HMAC-SHA256 sur `nonce + HTTP_METHOD + request_path + json_payload`, encodé en hexadécimal. Nonce v2 en cours de déploiement.
Pour plus de détails, reportez-vous à Bitso
Les endpoints spécifiques, les poids des limites de taux (rate limits), les listes de symboles et les paliers de frais se trouvent dans la documentation de Bitso. Considérez-les comme la source de vérité.
- docs.bitso.com/bitso-api/docsPrésentation de l'API de trading
- docs.bitso.com/bitso-api/docs/authenticationAuthentification et requêtes signées
- docs.bitso.com/bitso-api/docs/general-conceptsConcepts généraux (URL de base, limites de taux, sandbox)
- docs.bitso.com/bitso-api/docs/history-of-changesJournal des modifications de l'API (changelog)
Section 03 · Développer avec l’IA
Développez votre stratégie Bitso 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 Bitso native
Contrôle direct du comportement spécifique à Bitso, des données de compte et de la logique d'exécution des ordres via REST et WebSocket.
CCXT
Interface commune entre Bitso et d'autres exchanges crypto. L'identifiant d'exchange `bitso` couvre les endpoints spot.
Freqtrade
Déploiements basés sur le framework en utilisant la structure de stratégie de Freqtrade. Le support de Bitso est testé par la communauté via CCXT et n'est pas officiellement répertorié.
Connecteur sur mesure
Votre propre moteur de trading interne ou intégration propriétaire Bitso.
Support des frameworks pour Bitso
Bitso étant spot uniquement, la matrice des frameworks est plus simple que pour les plateformes multi-produits : il n'y a pas de colonne USD-M, COIN-M ou options à remplir. Si votre stratégie nécessite des perpétuels ou des futures margés en USD, associez Bitso à une autre plateforme (par exemple Binance, Bybit ou OKX) pour la jambe dérivée. Pour les stratégies Bitso spot uniquement, l'API native et CCXT sont les principales voies supportées ; Freqtrade fonctionne via CCXT (testé par la communauté), et Hummingbot ne propose pas de connecteur Bitso pour le moment.
✓ support confirmé selon la documentation officielle du framework. « partial » indique un test par la communauté via CCXT sans intégration officielle. « no connector » indique que le framework ne propose pas de connecteur Bitso. 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
Bitso 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 à Bitso.
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 à Bitso.
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) pour obtenir une base de travail.
- É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 (votre clé API Bitso, utilisée pour générer l'en-tête littéral Authorization: Bitso <key>:<nonce>:<sig> sur chaque requête signée), 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 Bitso
Les pièges qui vous guettent lorsque vous exécutez réellement une stratégie Bitso dans un runtime cloud conteneurisé, absents de la documentation de Bitso ou des fichiers README des frameworks. Chaque affirmation ci-dessous est citée ou paraphrasée de la propre documentation de Bitso ; les conseils côté déploiement proviennent de l'exécution de ces stratégies sur TradingHost.
01 · Passerelles fiat
SPEI, PIX et CBU/Alias locaux acheminent les devises fiat d'Amérique latine
Bitso achemine le MXN via SPEI (Mexique) et le BRL via PIX (Brésil) avec un règlement quasi instantané ; l'ARS utilise les passerelles locales CBU/Alias. Les stratégies qui dépendent de rechargements en devises fiat doivent prendre en compte les heures de coupure des réseaux et les jours fériés bancaires.
SourceBitso general concepts02 · Limites de requêtes
60 RPM public, 300 RPM privé
Les endpoints publics sont limités à 60 requêtes par minute par IP ; les endpoints privés sont limités à 300 requêtes par minute par compte sur une fenêtre glissante d'une minute. Tout dépassement déclenche un blocage d'une minute. Planifiez vos requêtes de polling et le rythme de vos ordres en conséquence ; privilégiez WebSocket pour les données de marché.
SourceBitso general concepts03 · Signature d'authentification
Un seul en-tête Authorization avec clé, nonce et signature
Bitso utilise un seul en-tête `Authorization: Bitso <key>:<nonce>:<sig>`. Le nonce doit être strictement croissant par clé ; la dérive d'horloge et les workers concurrents sont les causes habituelles de l'erreur `0215` (signature de requête incorrecte) et des rejets pour nonce invalide.
SourceBitso authentication04 · Niveaux de KYC
Les comptes vérifiés débloquent l'API privée et des limites plus élevées
Les comptes vérifiés débloquent l'accès à l'API privée et à des limites de retrait/dépôt plus élevées. Les limites par niveau et la déclaration obligatoire des transactions ont été renforcées dans le cadre de la réforme de lutte contre le blanchiment d'argent (AML) du Mexique de juillet 2025 (seuil de déclaration fixé à 210 UMA, soit environ 1 180 USD).
SourceBitso general concepts05 · Réglementation
Ley Fintech au Mexique, CNV PSAV en Argentine, GFSC à Gibraltar
Bitso opère au Mexique sous la loi Fintech de 2018 (Ley Fintech) administrée par la CNBV. Les services institutionnels d'actifs virtuels sont agréés via l'entité GFSC de Gibraltar. En Argentine, Bitso est enregistré en tant que PSAV no. 51 auprès de la CNV (depuis le 19 juillet 2024) et doit se conformer à la General Resolution 1058 d'ici le 31 décembre 2025.
SourceBitso general concepts
Section 06 · Conçu pour
Conçu pour
Les runtimes TradingHost pour Bitso sont particulièrement adaptés aux :
- Équipes quantitatives d'Amérique latine exécutant des paires en MXN, BRL et ARS depuis un runtime unique
- Développeurs basés au Mexique exécutant des stratégies automatisées financées via SPEI
- Desks crypto brésiliens routant la liquidité PIX vers les carnets spot en BRL
- Opérateurs d'arbitrage de stablecoins sur USDC/USDT face aux devises fiat d'Amérique latine
- Équipes de transfert de fonds et de trésorerie utilisant les réseaux de stablecoins sur le corridor Mexique-États-Unis
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é à Bitso.
Non. Le code de votre stratégie se connecte à Bitso et envoie des instructions selon votre propre logique, les permissions de votre compte et votre méthode d'intégration. TradingHost fournit le runtime dans lequel ce code s'exécute.
Non. L'accès à l'API de Bitso est fourni par Bitso. Vous êtes responsable de votre compte Bitso, des permissions de vos clés API, de vos identifiants et du respect des conditions d'utilisation de Bitso.
Non. TradingHost est le 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êts à l'emploi. 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 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 centralisation des 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 depuis 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. L'intégration bitso de CCXT couvre les endpoints spot, gère la signature HMAC-SHA256 et s'exécute sans modification dans un conteneur TradingHost. Les méthodes de marge et de futures ne s'appliquent pas car Bitso propose uniquement du spot. Consultez le runtime de 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 plus d'isolation et de clarté opérationnelle. Consultez la page du runtime TradingHost pour découvrir le modèle multi-stratégie.
La voie la plus rapide consiste à forker un runtime de framework TradingHost : CCXT 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 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 vos clés API et secrets. Consultez la section sur les secrets de la plateforme pour connaître le modèle complet de gestion.
Non. Les stratégies ne devraient jamais avoir besoin de permissions de retrait. Utilisez des permissions restreintes (lecture, trading) et activez la liste blanche d'adresses IP lorsque cela est possible. Réservez les droits de retrait aux clés que vous utilisez manuellement depuis un hôte à IP 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 en savoir plus.
Les deux. L'interface de contrôle MCP fonctionne tout 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 de 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 logs ainsi que 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 s'exécutant 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é.
Il s'agit presque toujours d'un problème de nonce ou de construction de la signature. Bitso exige un nonce strictement croissant par clé (Nonce v2 en cours de déploiement) et signe l'ensemble nonce + METHOD + path + body avec HMAC-SHA256, encodé en hexadécimal. Causes fréquentes : décalage d'horloge entre les réplicas, deux workers partageant la même clé, ou un slash final manquant dans le chemin d'accès.
Le SPEI au Mexique (MXN), le PIX au Brésil (BRL) et les options locales CBU/Alias en Argentine (ARS). Le règlement via PIX et SPEI s'effectue en quelques secondes, mais les heures limites de traitement des réseaux de paiement et les jours fériés s'appliquent toujours. Les stratégies qui rééquilibrent automatiquement les réserves de devises fiat doivent traiter la disponibilité de ces réseaux comme un paramètre d'exécution.
Bitso opère sous le régime de la Ley Fintech au Mexique sous la supervision de la CNBV, est enregistré auprès de la CNV en Argentine en tant que PSAV no. 51, est présent au Brésil et utilise une licence de la GFSC de Gibraltar pour ses services institutionnels d'actifs virtuels. La réforme de lutte contre le blanchiment d'argent (AML) de juillet 2025 au Mexique a ajouté des obligations de déclaration pour les VASP à partir d'environ 1 180 USD par transaction.
Non. Bitso ne propose pas de comptes aux résidents des États-Unis et restreint l'accès à environ 33 juridictions, dont les États-Unis et le Canada. TradingHost exécute votre stratégie quelle que soit la région, mais le compte Bitso lui-même doit être éligible selon les conditions d'utilisation de Bitso.
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 en production et le déploiement. Le backtesting relève de votre environnement de recherche, de votre framework ou d'AlgoBuilder.