Runtime natif IA pour stratégies Interactive Brokers
Développez dans Cursor, Claude Code ou n'importe quel IDE IA. Déployez depuis GitHub sur un runtime cloud managé avec un contrôle MCP de premier ordre, des logs et le choix de la région.
Section 01 · En un coup d’œil
En un coup d’œil
- Courtier
- Interactive Brokers LLC (Interactive Brokers Group, NASDAQ: IBKR)
- Type de courtier
- Courtier multi-produits régulé aux États-Unis, particuliers et institutionnels
- Classe d’actifs
- Actions américaines et internationales, options, futures, FX, obligations, ETF, fonds communs de placement, crypto, CFD (hors États-Unis)
- Actifs couverts
- Actions américaines (NYSE, NASDAQ, NYSE ARCA, BATS, IEX) et internationales sur plus de 150 marchés dans 33 pays. Options américaines (actions et indices compensés par l'OCC) et options sur futures. Futures et FOPs sur CME Group, ICE, Eurex, HKEX, OSE, SGX et autres. FX spot (plus de 100 paires, réseau IDEAL FX). Obligations : Bons du Trésor américain, obligations municipales américaines, obligations d'entreprises américaines, obligations d'États et d'entreprises internationales. ETF et fonds communs de placement. Trading de cryptomonnaies (clients américains) sur une plateforme partenaire ; clients hors États-Unis via des entités IBKR distinctes. CFD et warrants sur entités hors États-Unis. Produits structurés.
- 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
- TWS API (Python officiel ibapi, ib_insync, ib_async), Client Portal API (REST + OAuth2), Web API, FIX (institutionnel), NautilusTrader, Backtrader, connecteurs personnalisés
- Intégration du workflow d’IA
- Surface 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 la région, contrôle MCP
- Rôle de Interactive Brokers
- Compte de courtage, accès API, données de marché, lieu d'exécution, conservation (custody), règlement-livraison, déclaration fiscale, gestion de la marge
- Régulateurs
- Interactive Brokers LLC : courtier-négociant (broker-dealer) enregistré auprès de la SEC et de la FINRA (CRD 36418), Futures Commission Merchant et Forex Dealer Member enregistré auprès de la CFTC/NFA (NFA ID 0258600). Membre de la SIPC avec assurance complémentaire via Lloyds. Les entités du groupe sont également régulées par la FCA (Royaume-Uni), la CIRO (Canada), l'ASIC (Australie), la SFC (Hong Kong), la MAS (Singapour), la CBI (Irlande), et d'autres.
- Particuliers US
- Oui. Compte de paper trading inclus.
- Affiliation
- TradingHost est indépendant et n'est pas affilié à Interactive Brokers LLC ni à Interactive Brokers Group, Inc.
Section 02 · Ce que propose IBKR
Ce que propose Interactive Brokers
Interactive Brokers expose trois interfaces API distinctes (TWS API, Client Portal API, Web API) ainsi que le protocole FIX pour les institutionnels. Un même identifiant de compte permet d'accéder aux actions américaines et internationales, options, futures, FX, obligations, ETF, fonds communs de placement, cryptomonnaies et CFD sur entités hors États-Unis. Ces trois interfaces API présentent des capacités sensiblement différentes ; ce choix fait partie intégrante de la conception de votre stratégie.
Marchés et types de stratégies
- Portefeuilles multi-actifs combinant actions, options et futures
- Stratégies d'actions internationales sur plus de 150 marchés via Smart Routing
- Automatisation des futures et options sur futures CME, ICE et Eurex
- Stratégies spot IDEAL FX sur plus de 100 paires
- Stratégies d'options américaines basées sur la surface de volatilité et les Grecques
- Flux de travail de marge de portefeuille (portfolio margin) et de marge croisée multi-actifs
- Compte de paper trading pour des tests parallèles sans risque
Interface API
- Produits pris en charge
- Trois interfaces API distinctes d'Interactive Brokers : TWS API (protocole socket, nécessite un processus Trader Workstation ou IB Gateway en cours d'exécution locale), Client Portal API (REST + WebSocket, authentification OAuth 2.0) et Web API (interface REST plus récente). Le protocole FIX est proposé aux clients institutionnels. Chaque interface présente des capacités sensiblement différentes ; à choisir selon les besoins de votre stratégie.
- Méthodes de connexion
- TWS API utilise des sockets TCP connectés à une instance TWS ou IB Gateway active sur les ports 7496/7497 (réel/paper) pour TWS ou 4001/4002 (réel/paper) pour IB Gateway. Client Portal API s'appuie sur HTTPS REST et WebSocket sur api.ibkr.com. Web API utilise HTTPS REST. Wrappers : ibapi officiel (Python), ib_insync (communautaire) et le fork ib_async qui en assure la maintenance.
- Authentification
- TWS API : la stratégie se connecte à une passerelle locale préalablement authentifiée de manière interactive par le titulaire du compte. Client Portal API : OAuth 2.0 avec clé client (consumer key) et jetons de rafraîchissement (refresh tokens). Web API : jetons REST. Le paper trading utilise des identifiants et un numéro de compte distincts du compte réel.
Pour plus de précisions, reportez-vous à Interactive Brokers
Les endpoints spécifiques, limites de requêtes, minimums de compte, niveaux d'approbation d'options, abonnements aux données de marché et barèmes de commissions par marché figurent dans la documentation d'Interactive Brokers. Considérez-les comme la seule source de vérité.
- interactivebrokers.com/productsCouverture des produits et marchés
- ibkrcampus.com/ibkr-api-pagePortail API IBKR
- interactivebrokers.github.io/tws-apiDépôt officiel TWS API
- brokercheck.finra.org/firm-summary/36418FINRA BrokerCheck pour Interactive Brokers LLC
- nfa.futures.org BASIC (NFA ID 0258600)Enregistrement CFTC/NFA
Section 03 · Développer avec l’IA
Construisez votre stratégie IBKR avec l'IA
Choisissez une méthode d'intégration (TWS API pour un maximum de fonctionnalités, Client Portal API pour du cloud pur sans passerelle locale), dupliquez (fork) un projet de départ et développez 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.
TWS API (socket)
L'API phare d'IBKR. Elle offre le plus large éventail de fonctionnalités, mais nécessite un processus TWS ou IB Gateway actif localement auquel la stratégie se connecte. Utilisez ibapi (officiel) ou ib_async (fork communautaire asyncio d'ib_insync) pour Python.
Client Portal API (REST)
Interface REST et WebSocket authentifiée via OAuth 2.0. Moins complète que TWS API, elle ne nécessite pas de passerelle locale, ce qui facilite les déploiements exclusivement cloud.
Web API (REST)
Interface REST plus récente d'IBKR. Elle propose actuellement un sous-ensemble de fonctionnalités par rapport à TWS API et Client Portal ; sa couverture est en cours d'extension.
Framework ou connecteur personnalisé
NautilusTrader, Backtrader, QuantConnect et les moteurs internes encapsulent tous l'interface TWS API. Choisissez en fonction du framework que vous utilisez déjà.
Compatibilité des bibliothèques et frameworks avec les produits IBKR
ibapi et ib_async couvrent l'intégralité de TWS API, qui représente l'ensemble de fonctionnalités le plus large d'IBKR. Client Portal API fait l'impasse sur certains types d'ordres avancés au profit d'une approche REST + OAuth2 adaptée au cloud. Les adaptateurs de frameworks (NautilusTrader, Backtrader) encapsulent tous l'une des interfaces sous-jacentes ; leurs capacités dépendent donc directement de l'interface qu'ils enveloppent.
✓ support confirmé selon la documentation de la bibliothèque ou de l’adaptateur. « partial » indique une couverture partielle ; vérifiez la documentation actuelle de l’intégration avant de l’utiliser.
TradingHost n’impose aucune bibliothèque. La plateforme exécute votre projet.
Développer avec l’IA
Les clients REST ibapi, ib_async et Client Portal API fonctionnent tous avec les IDE IA. L'interface de contrôle MCP de TradingHost ferme la boucle : les outils d'IA peuvent inspecter les déploiements, examiner les journaux et gérer le runtime à vos côtés, sans jamais intervenir sur le chemin d'exécution des transactions.
Section 04 · Exécuter sur TradingHost
Exécutez votre code sur TradingHost
Interactive Brokers fournit le compte de courtage, l'accès à l'API et le lieu d'exécution. TradingHost fournit l'environnement de production dans lequel s'exécute votre stratégie connectée à IBKR.
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 conteneur géré par TradingHost.
Vous
- Votre dépôt contient votre code.
- Votre déploiement définit ses paramètres d’exécution.
- Votre stratégie se connecte à Interactive Brokers.
TradingHost
- Maintient l’environnement d’exécution en ligne.
- Expose les journaux et les bilans de santé.
- Sélection de la région.
- Interface de déploiement contrôlée.
Flux de déploiement
- ÉTAPE 01
Connecter GitHub
Autorisez TradingHost à accéder à votre compte GitHub.
- ÉTAPE 02
Lier un dépôt ou utiliser un modèle de départ
Pointez TradingHost vers le dépôt de votre stratégie IBKR existante, ou dupliquez (fork) un modèle de départ ibapi ou ib_async pour obtenir une base de travail fonctionnelle.
- ÉTAPE 03
Déployer dans un conteneur TradingHost
Choisissez une région (US-East est au plus près des moteurs d'appariement des actions américaines et des contrats à terme CME ; EU est le choix naturel pour les stratégies de la session européenne et les contrats à terme Eurex), renseignez vos identifiants IBKR et votre configuration de passerelle sous forme de variables d'environnement, puis déployez. TradingHost construit votre conteneur à partir du dépôt et exécute votre stratégie sur une infrastructure Kubernetes managée. Les stratégies TWS API nécessitant un processus IB Gateway local peuvent exécuter cette passerelle en tant que sidecar ; les stratégies basées sur Client Portal API et Web API n'ont pas besoin de passerelle.
- ÉTAPE 04
Suivre les journaux et l’état de santé
Suivez en direct les journaux, l’état de santé et le statut de l’environnement 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 CLI de lire l’état du déploiement et de gérer l’environnement d’exécution à vos côtés. L’exécution des transactions reste exclusivement sur le chemin du code de la stratégie, et non sur MCP.
- ÉTAPE 05
Mettre à jour et redéployer
Poussez vos modifications sur votre branche principale GitHub et TradingHost se redéploie automatiquement. Un déploiement configuré avec un compte de démonstration (paper trading) constitue l'environnement de test idéal avant de passer aux clés de production réelles.
Section 05 · Notes opérationnelles
Notes opérationnelles pour Interactive Brokers
Les pièges qui vous guettent lorsque vous exécutez réellement une stratégie Interactive Brokers dans un runtime cloud conteneurisé, pas toujours mentionnés dans la documentation d'IBKR ni dans les fichiers README des frameworks. Chaque affirmation ci-dessous est citée ou paraphrasée de la propre documentation d'Interactive Brokers ou d'une source réglementaire principale ; les conseils côté déploiement sont issus de l'exécution de ces stratégies sur TradingHost.
01 · Trois interfaces d'API
TWS API, Client Portal API et Web API ne sont pas interchangeables
Interactive Brokers expose trois interfaces de programmation distinctes. TWS API est un protocole socket utilisé par ibapi et ib_async ; il nécessite un processus TWS ou IB Gateway en cours d'exécution auquel la stratégie se connecte. Client Portal API est une API REST et WebSocket avec OAuth 2.0 ; elle ne nécessite pas de passerelle locale. Web API est une interface REST plus récente dont la couverture est actuellement plus restreinte. Choisissez l'interface dès la conception de la stratégie ; en changer en cours de déploiement nécessite une réécriture du code, pas un simple changement de paramètre.
02 · Passerelle locale TWS
TWS API nécessite un processus TWS ou IB Gateway local auquel la stratégie se connecte
TWS API est un protocole socket qui se connecte à une instance TWS (Trader Workstation) ou IB Gateway exécutée localement sur le port 7496 ou 7497 for TWS, ou 4001 ou 4002 for IB Gateway (respectivement pour le trading réel et de démonstration). Pour les déploiements exclusivement cloud, exécutez IB Gateway dans un conteneur sidecar aux côtés de la stratégie, ou utilisez plutôt Client Portal API. La passerelle « locale » peut résider dans le même conteneur TradingHost ou dans un conteneur adjacent au sein du même pod Kubernetes.
SourceIB Gateway documentation03 · Compte de démonstration
Le paper trading utilise un numéro de compte et des identifiants distincts
Le paper trading sur Interactive Brokers est fourni sous la forme d'un numéro de compte distinct plutôt que d'une URL d'environnement séparée. L'utilisateur se connecte à TWS ou IB Gateway avec ses identifiants de démonstration, et la passerelle se connecte au service de paper trading. Le code de la stratégie ne change pas entre le mode réel et le mode démonstration, mais la configuration de la passerelle et de la connexion API (port et identifiant de compte) si. Conservez vos identifiants réels et de démonstration dans des entrées de Secrets TradingHost distinctes.
04 · Pattern Day Trader
La règle PDT s'applique aux comptes sur marge inférieurs à $25,000 selon la FINRA Rule 4210
La FINRA Rule 4210 qualifie un compte sur marge de Pattern Day Trader après quatre transactions intrajournalières ou plus sur une période de cinq jours ouvrables, et restreint les transactions intrajournalières ultérieures jusqu'à ce que l'actif net atteigne $25,000. Interactive Brokers applique cette règle aux comptes sur marge. Les comptes au comptant (cash accounts) ne sont pas soumis à la règle PDT mais sont soumis aux contraintes du cycle de règlement-livraison (T+1 pour les actions américaines depuis le 2024-05-28). Planifiez votre déploiement en tenant compte de cette contrainte.
05 · Approbation pour les options
L'approbation pour les options est accordée par compte et est distincte de celle pour les actions
Le trading d'options sur IBKR nécessite une étape d'approbation distincte de l'ouverture de compte standard. Le niveau d'approbation détermine les stratégies d'options acceptées par le courtier : options d'achat couvertes (covered calls) et options de vente garanties par des liquidités (cash-secured puts) au niveau le plus bas, options courtes non couvertes (uncovered short options) au niveau le plus élevé. Les ordres qui dépassent le niveau approuvé sont rejetés par le courtier, et non par TradingHost. Concevez vos stratégies en fonction de votre niveau approuvé ou demandez une mise à niveau d'approbation auprès d'IBKR avant le déploiement.
06 · Données de marché
Les abonnements aux données de marché se font par marché et ne sont pas regroupés par défaut
Interactive Brokers facture les abonnements aux données de marché par marché (profondeur US NASDAQ, NYSE OpenBook, options OPRA US, contrats à terme CME, profondeur LSE, etc.). Une stratégie qui interroge des données de marché sans abonnement actif reçoit des cotations différées ou des réponses vides. Configurez vos abonnements aux données sur le portail utilisateur avant de déployer une stratégie qui dépend de données en temps réel sur un marché spécifique.
07 · SmartRouting
SmartRouting est activé par défaut ; l'acheminement direct se fait par ordre
Interactive Brokers achemine par défaut les ordres via SmartRouting, qui sélectionne le lieu d'exécution offrant le meilleur prix affiché, net de commissions. Pour utiliser un acheminement direct, spécifiez un paramètre de place boursière (exchange) sur l'ordre. SmartRouting influe sur l'exécution, la latence et les ristournes de frais de bourse ; les stratégies qui dépendent d'une interaction avec une place boursière spécifique doivent opter pour l'acheminement direct.
Section 06 · Conçu pour
Conçu pour
Les runtimes TradingHost Interactive Brokers sont particulièrement adaptés pour :
- Développeurs concevant des stratégies dans des IDE IA (Cursor, Claude Code)
- Traders systématiques multi-actifs
- Opérateurs de stratégies sur options et contrats à terme
- Développeurs quantitatifs passant des notebooks à la production
- Auteurs de stratégies sur actions internationales et FX
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é à Interactive Brokers LLC ni à Interactive Brokers Group, Inc.
Non. TradingHost est un environnement d'exécution (runtime) pour le code de vos stratégies de trading. Interactive Brokers LLC est le courtier-négociant (broker-dealer), enregistré auprès de la SEC et de la FINRA (CRD 36418), de la CFTC et de l'NFA (NFA ID 0258600), et membre de la SIPC avec une couverture d'assurance excédentaire via Lloyds. Votre compte, la garde des actifs, l'accès au marché, le règlement-livraison, la marge et les déclarations fiscales relèvent tous d'Interactive Brokers.
Non. Le code de votre stratégie se connecte à Interactive Brokers et envoie des instructions d'ordre selon votre propre logique, les autorisations 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 d'IBKR est fourni par Interactive Brokers. Vous êtes responsable de votre compte IBKR, des autorisations d'API, de vos identifiants et du respect des conditions d'utilisation d'IBKR.
TWS API (via ibapi ou ib_async) offre la couverture fonctionnelle la plus large mais nécessite un processus TWS ou IB Gateway en cours d'exécution locale. Client Portal API utilise REST et OAuth 2.0 et ne nécessite pas de passerelle locale, ce qui la rend plus simple pour les déploiements exclusivement cloud. Si votre stratégie requiert des types d'ordres avancés, les grecques d'options en temps réel ou des fonctionnalités que seul le protocole socket de TWS expose, utilisez TWS API et exécutez IB Gateway en tant que sidecar. Si une API REST convient, privilégiez Client Portal API pour un déploiement plus simple.
Oui, si vous choisissez TWS API. IB Gateway est une application Java légère qui s'authentifie auprès d'IBKR et expose un socket local auquel la stratégie se connecte. Sur TradingHost, vous exécutez IB Gateway en tant que processus sidecar dans le même pod Kubernetes que la stratégie, ou vous utilisez plutôt Client Portal API, ce qui élimine la dépendance à la passerelle.
Oui, sous réserve de l'approbation des options par IBKR. L'approbation pour les options est accordée par compte et est distincte de celle pour les actions ; le niveau d'approbation détermine les stratégies acceptées par le courtier. TradingHost ne contourne pas l'approbation des options.
Oui, sous réserve de l'approbation du compte pour les contrats à terme par IBKR. Le trading de contrats à terme nécessite une étape d'approbation distincte de l'ouverture de compte standard en raison des exigences de la CFTC et de l'NFA.
ibapi est le wrapper Python officiel d'Interactive Brokers et reflète directement le protocole socket. ib_insync était un wrapper communautaire compatible avec asyncio ; son auteur d'origine l'a marqué comme n'étant plus activement maintenu. ib_async est le fork communautaire de ib_insync qui continue de publier des mises à jour. Pour les nouvelles stratégies, utilisez ibapi ou ib_async ; pour le code ib_insync existant, planifiez une migration vers ib_async car l'API est largement compatible.
Connectez votre dépôt GitHub contenant le code de votre stratégie, associez-le à TradingHost et lancez le déploiement. Utilisez un déploiement configuré avec un compte de démonstration (paper account) comme environnement de test, puis passez aux clés réelles une fois la stratégie stable. L'association de GitHub et la création d'une stratégie sont gratuites ; les abonnements 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 lors de l'exécution via les secrets de dépôt GitHub, les secrets d'environnement ou votre propre processus de gestion des secrets. TradingHost n'a pas besoin de conserver votre nom d'utilisateur IBKR, votre mot de passe ou vos jetons OAuth Client Portal API. Consultez la page sur les secrets de la plateforme pour en savoir plus sur le modèle de gestion.
Non. Les stratégies ne devraient jamais nécessiter d'autorisations de retrait ou de transfert de fonds. Vos identifiants ont uniquement besoin des droits requis pour la transmission d'ordres et l'accès aux données de marché.
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 journaux, redémarrer les stratégies et gérer les flux d'exécution. MCP est une interface de contrôle et d'observabilité, pas le chemin d'exécution des transactions. Consultez la page sur l'interface de contrôle MCP pour en savoir plus.
Non. La règle PDT (FINRA Rule 4210) est appliquée par Interactive Brokers, et non par TradingHost. Les comptes sur marge inférieurs à 25 000 $ sont soumis aux restrictions de day trading de la règle PDT. Votre stratégie doit respecter l'indicateur PDT appliqué par le courtier sur votre compte.
Non. Vos formulaires 1099 sont fournis par Interactive Brokers en fin d'année, et non par TradingHost. TradingHost fournit l'environnement d'exécution ; IBKR gère les déclarations fiscales liées à votre compte de courtage.
Non. La SIPC couvre votre compte de courtage IBKR jusqu'à 500 000 $ (dont 250 000 $ en espèces) dans le cadre de la protection des membres de la SIPC, avec une assurance complémentaire proposée par IBKR via Lloyds. L'environnement d'exécution de TradingHost n'est pas couvert par la SIPC car TradingHost n'est pas un courtier.
TradingHost est disponible dans les régions EU and US-East. US-East est au plus près des moteurs d'appariement des actions américaines et des contrats à terme CME, ce qui en fait le choix naturel pour la plupart des stratégies IBKR sur les marchés américains. La région EU est quant à elle idéale pour les stratégies de la session européenne et les contrats à terme Eurex. 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.