Temps de lecture : … min

Environnement d'exécution natif IA pour stratégies de trading Bybit

Créez vos stratégies dans Cursor, Claude Code ou n'importe quel IDE IA. Déployez depuis GitHub dans un environnement d'exécution cloud managé avec contrôle MCP natif, logs et choix de la région.

Par l’équipe d’ingénierie de TradingHost

Section 01 · En un coup d’œil

En un coup d’œil

Plateforme
Bybit
Type de plateforme
Plateforme d'échange crypto (orientée dérivés)
Classe d’actifs
Crypto (spot, contrats perpétuels linéaires et inverses, futures USDC, options, spread)
Produits pris en charge
Spot, contrats perpétuels USDT, contrats perpétuels USDC, futures USDT, futures USDC, contrats perpétuels inverses, futures inverses, options USDC de style européen, Spread Trading, stratégies de copy trading, demo trading. Disponible via UTA 2.0 (par défaut pour les comptes créés à partir de 2025) ; UTA 1.0 reste actif pour les anciens utilisateurs. Les comptes Classic ne sont plus proposés.
Modèle d’exécution
Environnement d'exécution conteneurisé pour stratégies
Source de déploiement
GitHub
Langages
Tout langage compatible avec un conteneur
Intégrations courantes
API natives Bybit v5 REST et WebSocket, CCXT, Freqtrade, Hummingbot, 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
Environnement d'exécution, déploiement, logs, suivis d'état, choix de la région, contrôle MCP
Rôle de Bybit
Compte d'échange, accès API, accès au marché, exécution des ordres
Affiliation
TradingHost est indépendant et n'est pas affilié à Bybit

Section 02 · Ce que propose Bybit

Ce que propose Bybit

L'API v5 de Bybit unifie le spot, les contrats perpétuels linéaires et inverses, les futures USDT et USDC, ainsi que les options USDC de style européen derrière un paramètre unique `category`, avec le Spread Trading et le Demo Trading comme interfaces additionnelles. Sous UTA 2.0, chaque category partage un pool de marge multi-produits unique. Les stratégies s'authentifient avec des clés HMAC-SHA256 (générées par le système) ou RSA-SHA256 (générées par l'utilisateur) et communiquent avec la plateforme via REST ou WebSocket. Le mainnet, le testnet et le mainnet demo sont trois environnements distincts avec des espaces de noms de clés disjoints. Les spécificités des endpoints évoluent avec le temps. L'architecture globale reste stable ; les limites de requêtes précises, les paliers de frais et les listes de symboles sont détaillés dans la documentation de Bybit.

Marchés et types de stratégies

  • Market making sur contrats perpétuels USDT
  • Arbitrage de base et carry trade sur contrats perpétuels USDC
  • Couverture en marge crypto (coin-margined) sur contrats perpétuels inverses
  • Scalping de gamma sur options (règlement en USDC, Portfolio Margin)
  • Arbitrage de taux de financement via le carnet d'ordres de Spread Trading
  • Automatisation de stratégies de copy trading via Master Trader
  • Stratégies de marge de portefeuille multi-produits sous UTA 2.0
  • Tests à blanc en demo-trading avant déploiement sur le mainnet

Interface API

Produits couverts
Catégories v5 unifiées (`spot`, `linear`, `inverse`, `option`), plus endpoints de Spread Trading et Demo Trading. UTA 2.0 unifie toutes les catégories sous un seul pool de marge. Le mainnet, le testnet (api-testnet.bybit.com) et le mainnet demo (api-demo.bybit.com) sont trois environnements distincts avec des espaces de noms de clés disjoints.
Méthodes de connexion
REST v5 (HTTPS), WebSocket public (données de marché), WebSocket privé (ordres, exécutions, positions, portefeuille), WebSocket trade (saisie d'ordres via WS, mainnet uniquement).
Authentification
HMAC-SHA256 (clés générées par le système) ou RSA-SHA256 (clés générées par l'utilisateur). En-têtes requis : `X-BAPI-API-KEY`, `X-BAPI-TIMESTAMP`, `X-BAPI-SIGN`, `X-BAPI-RECV-WINDOW` (par défaut 5000 ms). Prise en charge de la hiérarchie des sous-comptes et de la restriction IP par clé. L'accès à l'API depuis des IP des États-Unis ou de Chine continentale renvoie une erreur HTTP 403.

Pour plus de détails, reportez-vous à Bybit

Les endpoints spécifiques, les limites de requêtes, les listes de symboles, les paliers de frais et l'historique des versions sont disponibles dans la documentation de Bybit. Considérez-les comme la seule source de vérité.

Section 03 · Développer avec l’IA

Développez votre stratégie Bybit avec l’IA

Choisissez une méthode d'intégration, dupliquez (fork) un modèle de framework TradingHost, et créez votre stratégie dans un IDE IA. Cursor, Claude Code, GitHub Copilot et les agents IA en ligne de commande fonctionnent tous avec le même cycle de déploiement natif GitHub. Grâce à l'architecture par category de Bybit v5 et à la marge multi-produits d'UTA 2.0, une seule stratégie peut accéder au spot, aux contrats perpétuels, aux futures et aux options via un compte unifié unique.

  • API native Bybit

    Contrôle direct du comportement spécifique à Bybit, des données de compte et de la logique d'exécution des ordres via l'API unifiée v5.

  • CCXT

    Interface commune entre Bybit et d'autres plateformes d'échange crypto.

  • Freqtrade ou Hummingbot

    Déploiements basés sur des frameworks utilisant leur propre structure de stratégie et modèle de configuration.

  • Connecteur sur mesure

    Votre propre moteur de trading interne ou intégration propriétaire Bybit.

Compatibilité des frameworks avec les produits Bybit

La couverture varie selon le framework. CCXT et l'API native v5 couvrent l'intégralité des produits Bybit ; Freqtrade prend en charge le spot et les contrats perpétuels linéaires (un sous-compte par bot est recommandé) ; Hummingbot prend en charge le spot et les contrats perpétuels avec un support partiel des contrats inverses (un seul mode à la fois).

FrameworkSpotPerpInverseOptions
Native Bybit v5Pris en chargePris en chargePris en chargePris en charge
CCXTPris en chargePris en chargePris en chargePris en charge
FreqtradePris en chargePris en chargeSupport non documentéSupport non documenté
HummingbotPris en chargePris en chargePartiellement pris en chargeSupport non documenté

✓ support confirmé selon la documentation officielle du framework. « partial » indique un support documenté mais limité (ex. un seul mode à la fois). « no » indique qu'aucun support n'est officiellement documenté.

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

Bybit 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 à Bybit.

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 à Bybit.

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

  1. ÉTAPE 01

    Connecter GitHub

    Autorisez TradingHost à accéder à votre compte GitHub.

  2. É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.

  3. É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és API Bybit, etc.) et déployez. TradingHost construit votre conteneur à partir du dépôt et exécute votre stratégie sur une infrastructure Kubernetes gérée. Aucune installation locale de Docker n’est requise.

  4. É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.

  5. É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 Bybit

Les pièges réels qui vous guettent lorsque vous exécutez une stratégie Bybit dans un environnement cloud conteneurisé, absents de la documentation Bybit et des fichiers README des frameworks. Chaque point ci-dessous est cité ou paraphrasé à partir de la documentation officielle de Bybit ; les conseils liés au déploiement proviennent de l'exploitation de ces stratégies sur TradingHost.

  1. 01 · Unification v5

    L'API v5 unifie les catégories ; la v3 a été retirée en août 2024

    L'API v5 de Bybit unifie le spot, les contrats perpétuels linéaires et inverses, ainsi que les options derrière un paramètre unique `category`. La transition officielle de la v3 à la v5 a entraîné le retrait des endpoints v3 le 31 août 2024. Exécutez tout nouveau code sur la v5 ; la v3 renvoie désormais des erreurs.

  2. 02 · Environnements

    Le mainnet, le testnet et le mainnet demo sont trois hôtes distincts

    Le Mainnet utilise api.bybit.com et stream.bybit.com. Le Testnet utilise api-testnet.bybit.com et stream-testnet.bybit.com. La démo Mainnet utilise api-demo.bybit.com et wss://stream-demo.bybit.com pour les flux privés (les données de marché publiques proviennent toujours du mainnet). Les clés ne sont pas partagées entre les environnements ; une clé de démo utilisée sur l'hôte testnet renvoie l'erreur 10003. WS Trade (saisie d'ordres via WebSocket) n'est pas disponible en démo.

  3. 03 · Mode de compte

    UTA 2.0 vs UTA 1.0 vs Classic historique

    Trois modes de compte ont existé : Classic (qui n'est plus proposé), UTA 1.0 (spot unifié avec les dérivés et options USDT/USDC ; l'inverse reste séparé) et UTA 2.0 (chaque category partageant un seul pool de marge avec marge croisée ou de portefeuille). Les comptes enregistrés en 2025 ou après sont en UTA 2.0 par défaut. La mise à niveau vers l'UTA est irréversible ; en UTA 2.0, les contrats à terme inverse ne prennent plus en charge le hedge mode.

  4. 04 · Limites de taux

    Fenêtre glissante par UID et par category

    Les limites de la v5 s'appliquent par fenêtre glissante par UID et sont partitionnées par category. La création d'ordres est de 20/s pour le spot et le linear, 10/s pour l'inverse et l'option ; la modification est de 10/s pour les quatre ; l'annulation suit les mêmes limites que la création. Le plafond au niveau de l'IP est de 600 requêtes HTTP par fenêtre de 5 secondes. Les endpoints de lot (batch) consomment par ordre et non par requête, avec des plafonds de 10 (spot) et 20 (linear / inverse / option) par lot. Les en-têtes de réponse indiquent le budget restant.

  5. 05 · Historique de sécurité

    Incident Lazarus de février 2025, ce qui a changé

    Le 21 février 2025, des attaquants liés au Lazarus Group (TraderTraitor) de Corée du Nord ont dérobé environ 1,5 milliard de dollars en ETH d'un cold wallet de Bybit en compromettant le poste de travail d'un développeur chez le fournisseur tiers de multisig Safe{Wallet} et en altérant l'interface de signature. Le FBI a confirmé l'attribution dans l'avis IC3 PSA-250226. Bybit est resté opérationnel : les retraits ont continué, l'audit Proof of Reserves de Hacken a confirmé des réserves supérieures à 100 % pour le BTC, l'ETH, le SOL, l'USDT et l'USDC, et Bybit a déclaré publiquement que les fonds des utilisateurs n'étaient pas touchés. Bybit a ensuite isolé son infrastructure de signature, repensé ses flux multisig, audité les outils tiers, ajouté une détection d'anomalies sur les transferts et poursuit ses audits mensuels Merkle-tree PoR avec Hacken. Pour les utilisateurs de l'API, il s'agit d'un contexte historique : la posture de sécurité a évolué, mais l'interface technique est restée identique.

  6. 06 · Restrictions géographiques

    États-Unis et Chine continentale bloqués au niveau de l'API

    Le guide de la v5 stipule explicitement que les adresses IP situées aux États-Unis ou en Chine continentale reçoivent une erreur 403 Forbidden. Des noms d'hôte régionaux existent pour les Pays-Bas, la Turquie, le Kazakhstan, la Géorgie, les Émirats arabes unis, l'EEE et l'Indonésie. Le KYC est obligatoire et l'identité d'un résident américain est bloquée lors de la vérification, même si l'IP est acceptée. Le choix de la région d'exécution sur TradingHost doit éviter les régions américaines pour cibler Bybit.

  7. 07 · Erreurs courantes

    Codes d'authentification et de limite de taux à gérer

    L'erreur 10003 invalid api_key signifie généralement un mauvais environnement (clé mainnet envoyée à l'hôte testnet ou clé démo envoyée au mainnet). L'erreur 10004 invalid sign indique un décalage d'horloge supérieur à `recv_window`, ou une charge utile de signature assemblée dans le mauvais ordre. L'erreur 10018 exceed IP rate limit signale le dépassement du plafond de 600 req / 5 s ; réduisez la cadence en utilisant `X-Bapi-Limit-Reset-Timestamp`. Traisez les erreurs 10003 et 10004 comme des alertes nécessitant un arrêt, et non comme des cas de nouvel essai.

  8. 08 · Spread Trading

    Le Spread Trading dispose d'un carnet d'ordres distinct

    Le Spread Trading prend en charge les combinaisons Spot/Perp, Spot/Expiry, Perp/Expiry et Expiry/Expiry sur BTC, ETH et SOL avec son propre carnet d'ordres et des frais 50 % moins élevés que l'exécution manuelle jambe par jambe. Il est répertorié comme une fonctionnalité dans la documentation v5 plutôt que comme une `category` documentée ; passez par les références d'endpoint du centre d'aide lors du développement.

Section 06 · Conçu pour

Conçu pour

Les runtimes TradingHost pour Bybit 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é à Bybit.

Non. Le code de votre stratégie se connecte à Bybit et envoie des instructions selon votre propre logique, vos autorisations de 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 Bybit est fourni par Bybit. Vous êtes responsable de votre compte Bybit, des autorisations de l'API, de vos identifiants et du respect des conditions d'utilisation de Bybit.

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 stratégies préconçues. 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, 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é, 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 journaux 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 environnement d'exécution sous forme de service géré, TradingHost est la voie la plus rapide.

Oui. TradingHost exécute les stratégies Python ; choisissez l'environnement d'exécution de framework qui correspond à votre stack ou déployez votre propre dépôt.

Oui. TradingHost prend en charge tous les langages capables de s'exécuter dans un conteneur.

Oui. L'intégration bybit de CCXT couvre le spot, les perpétuels linear et inverse, les contrats à terme USDT et USDC, ainsi que les options USDC via la v5. Déployez votre stratégie CCXT depuis GitHub dans un environnement d'exécution TradingHost ; nous l'exécutons, vous gardez vos clés. Consultez l'environnement d'exécution 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 environnement d'exécution, ou les séparer dans différents environnements pour plus d'isolation et de clarté opérationnelle. Consultez la page de l'environnement d'exécution TradingHost pour découvrir le modèle multi-stratégie.

La méthode la plus rapide consiste à forker 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 d'exécution sont détaillés sur la page des tarifs.

Dans votre workflow 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 d'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 d'autorisations de retrait. Utilisez des autorisations restreintes et une liste blanche d'IP par clé lorsque c'est possible, et conservez les droits de retrait sur une clé distincte gérée manuellement.

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. Les outils d'IA peuvent inspecter les déploiements, consulter les journaux, redémarrer les stratégies et gérer les workflows d'exécution. Le protocole 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 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 via 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 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é.

Trois causes expliquent la quasi-totalité des erreurs 10004 : un horodatage de requête en dehors de la fenêtre recv_window (par défaut 5000 ms) en raison d'une dérive de l'horloge, une charge utile de signature assemblée avec des paramètres dans le mauvais ordre, ou l'utilisation accidentelle du format de charge utile HMAC avec une clé RSA (ou inversement). Synchronisez l'horloge de votre runtime ou récupérez l'heure du serveur Bybit avant de signer. Consultez la section Notes opérationnelles ci-dessus pour obtenir le guide complet.

Bybit exploite trois environnements avec des espaces de noms de clés disjoints : mainnet, testnet (api-testnet.bybit.com) et mainnet demo (api-demo.bybit.com). Une clé créée pour l'un d'eux renverra l'erreur 10003 sur les deux autres. Générez une nouvelle clé depuis le tableau de bord correspondant.

Les comptes ouverts en 2025 ou après utilisent par défaut UTA 2.0. Si vous êtes sur Classic ou UTA 1.0 et souhaitez bénéficier de la marge croisée multi-produits, effectuez la mise à niveau. Cette mise à niveau est irréversible et les contrats à terme inverse perdent le mode hedge. Faites d'abord un test sur l'environnement de démo.

Non. Bybit bloque les adresses IP des États-Unis et de Chine continentale au niveau de l'API avec une réponse 403, et les procédures KYC rejettent les résidents américains. TradingHost ne peut pas contourner cette restriction, qui est imposée directement par Bybit.

L'incident était réel, d'envergure et bien documenté (FBI IC3 PSA-250226). Les opérations à chaud, les retraits et les soldes des clients de Bybit n'ont pas été affectés ; l'audit Proof of Reserves de Hacken daté du 26 février a confirmé des réserves supérieures à 100 % pour les principaux actifs. Depuis, Bybit a isolé son infrastructure de signature, repensé ses flux multisig et poursuit ses audits mensuels Merkle-tree PoR. Pour l'utilisateur d'une stratégie algorithmique, il s'agit d'un élément de contexte opérationnel et non d'un blocage de l'API, mais considérez le risque de garde des plateformes d'échange comme réel et gérez la taille de vos positions en conséquence.

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. Notez que Bybit bloque les adresses IP américaines en périphérie de son API. Par conséquent, les stratégies Bybit ne doivent pas être routées depuis la région US-East. Consultez la page des régions pour en savoir plus 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.