Broker

Le composant Broker gère le côté exécution du trading dans TheoryCraft. Il prend en charge le placement d'ordres, le suivi des positions, l'historique des trades et l'état du compte.

⚠️ Le composant Broker est actuellement en développement.

Qu'est-ce que le Broker ?

Dans TheoryCraft, le Broker sert d'interface entre votre logique de stratégie et l'exécution des ordres. Que vous backtestiez sur des données historiques ou que vous tradiez en live, le Broker fournit une API cohérente pour :

  • Placer et gérer des ordres
  • Suivre les positions ouvertes
  • Maintenir l'historique des trades
  • Rapporter le solde et l'équité du compte

Le Broker abstrait les différences entre l'exécution simulée et réelle, permettant au même code de stratégie de fonctionner dans tous les environnements.

Responsabilités du Broker

Gestion des Ordres

Le Broker reçoit les demandes d'ordres des Engines et gère leur cycle de vie :

  • Soumission d'ordres - Valider et soumettre des ordres au marché, à cours limité et stop
  • Suivi des ordres - Surveiller les ordres en attente, exécutés et annulés
  • Modification d'ordres - Modifier ou annuler des ordres existants

Suivi des Positions

Le Broker maintient l'état actuel de toutes les positions :

  • Positions ouvertes avec prix d'entrée et taille
  • Profit et perte non réalisés
  • Historique des positions et trades clôturés

État du Compte

Le Broker suit les informations au niveau du compte :

  • Solde disponible et marge
  • Équité totale
  • Profit et perte réalisés

Modes d'Exécution

Le Broker supporte trois modes d'exécution avec une API unifiée :

Simulé (Backtesting)

Pour le backtesting, le Broker simule l'exécution des ordres sur des données de marché historiques. Il modélise des exécutions réalistes basées sur les prix disponibles, en tenant compte de facteurs comme le slippage et le spread.

Paper Trading

Le paper trading utilise des données de marché en temps réel avec une exécution simulée. Cela permet de valider une stratégie dans des conditions de marché réelles sans risquer de capital.

Trading Live

Pour le trading live, le Broker se connecte à des brokers et exchanges externes pour exécuter de vrais ordres. La même logique de stratégie utilisée en backtesting s'exécute sans modification en production.

BrokerEvent

Le Broker émet des structures BrokerEvent pour notifier les Engines des mises à jour d'exécution :

  • Changements de statut d'ordre (soumis, exécuté, annulé, rejeté)
  • Mises à jour de position (ouverte, modifiée, clôturée)
  • Changements de solde du compte

Les Engines consomment ces événements en parallèle des MarketEvents pour prendre des décisions de trading.

Intégrations Prévues

Les intégrations broker suivantes sont prévues :

Broker Classes d'Actifs Statut
Broker Simulé Tous (backtesting) En développement
Interactive Brokers Actions, Options, Futures, Forex Prévu
Binance Cryptomonnaies Prévu

Prochaines Étapes