Opérations sur les cBots¶

Cet article présente le cycle de vie d’un cBot dans cTrader CLI. Vous apprendrez à exécuter un cBot depuis un terminal, à afficher et arrêter les instances en cours d’exécution, à héberger un cBot sur un VPS ou un serveur cloud avec Docker et à effectuer un backtest sur des données historiques.

Prérequis ¶

• cTrader CLI est installé.
• Votre cTrader ID, votre fichier d’identifiants et votre numéro de compte sont prêts.
• Le cBot est exporté sous forme de fichier .algo compilé pour .NET 8.

Lire les métadonnées d’un cBot ¶

Avant d’exécuter un cBot, utilisez metadata pour afficher les paramètres qu’il accepte. La sortie indique le nom et le type de chaque propriété du cBot.

ctrader-cli metadata <path-to-algo-file>

Utilisez les noms des paramètres indiqués dans la sortie des métadonnées lorsque vous fournissez des paramètres en ligne de commande ou dans un fichier .cbotset.

Exécuter un cBot ¶

Démarrez un cBot avec run. Le chemin du fichier .algo est le premier argument. --account, --symbol et --period sont obligatoires.

ctrader-cli run <path-to-algo-file> --account=<account-id> --symbol=<symbol> --period=<period>

Trois façons de transmettre les paramètres.

Deux options facultatives sont importantes pour les exécutions sans surveillance.

Exécuter un cBot sur un VPS ou un serveur cloud ¶

Un outil utilisable uniquement dans un terminal fonctionne parfaitement sur une petite instance Linux. Un cBot peut ainsi s’exécuter en continu à moindre coût que sur un ordinateur de bureau. L’image Docker de cTrader CLI est la solution la plus portable pour cela.

Téléchargez la dernière image :

docker pull ghcr.io/spotware/ctrader-console:latest

Exécutez un cBot dans un conteneur. L’option --mount associe un dossier de l’hôte à un emplacement dans le conteneur ; les options -e transmettent la configuration par des variables d’environnement :

docker run -d -it \
  --name ctrader.console.run.mybot \
  --mount type=bind,src=/cAlgo/Robots,dst=/mnt/Robots \
  -e CTID='mycid' \
  -e PWD-FILE='/mnt/Robots/ctrader-cli.pwd' \
  -e ACCOUNT='9102302' \
  -e SYMBOL='EURUSD' \
  -e PERIOD='H1' \
  ghcr.io/spotware/ctrader-console:latest run "/mnt/Robots/My bot.algo" --environment-variables

Lancer depuis l’application de bureau cTrader ¶

Vous n’avez pas besoin de maîtriser la ligne de commande pour profiter de cTrader CLI.

1. Dans l’application de bureau cTrader, préparez un cBot avec les paramètres de votre choix.
2. Faites un clic droit sur une instance locale du cBot et sélectionnez Démarrer dans un processus externe. cTrader CLI se lance automatiquement et exécute l’instance de manière indépendante.
3. Fermez l’application de bureau pour économiser les ressources du processeur et la mémoire vive. Le cBot continue de fonctionner dans le processus cTrader CLI.

Afficher et arrêter les cBots ¶

Affichez les instances de cBot actuellement en cours d’exécution sur le compte :

ctrader-cli cbots --ctid=letstrade --password=secret --account=1234567 -q

Arrêtez une instance en cours d’exécution à l’aide de son identifiant, indiqué dans la sortie de run :

ctrader-cli stop --ctid=letstrade --password=secret --account=1234567 -q --instance=<instance-id>

Pour arrêter simultanément tous les cBots en cours d’exécution, ouvrez le shell interactif et exécutez stop all yes. Le processus cTrader CLI se termine lorsque la dernière instance s’arrête.

Effectuer un backtest d’un cBot ¶

Exécutez un cBot sur des données historiques avec backtest. Le chemin du fichier .algo est le premier argument. Il peut être suivi d’un fichier .cbotset facultatif. Le test nécessite également un symbole, une période et une plage de dates :

ctrader-cli backtest <path-to-algo-file> [<path-to-cbotset-file>] --account=<account-id> --symbol=<symbol> --period=<period> --start=<start-date> --end=<end-date> --data-mode=<data-mode>

Options du contexte de test ¶

Les options du contexte de test sont décrites dans l’entrée backtest de la documentation de référence CLI. Les seuls paramètres obligatoires sont --start, --end et --data-mode. Les options facultatives concernent le solde initial, les commissions, le spread, les sources de données et les fichiers de rapport.

Modes de données ¶

Exemple pratique ¶

Effectuez un backtest sur un exemple de cBot avec un seul fichier de paramètres .cbotset :

ctrader-cli backtest "C:/test/sample martingale.algo" C:/test/special-parameters.cbotset \
  --ctid=letstrade --pwd-file=C:/test/password.pwd --account=1234567 --symbol=EURUSD --period=h1 \
  --start="01/01/2025 12:34" --end="31/01/2025 20:56" \
  --balance=10000 --commission=30 --commission-type=UsdPerMillionUsdVolume --spread=1 --data-mode=m1

Résultats du backtest ¶

cTrader CLI affiche la progression en continu dans le terminal, puis un récapitulatif à la fin. Le résultat complet se trouve dans un dossier Backtesting à côté du fichier .algo, avec un sous-dossier pour chaque exécution :

…/data/{cBotName}/{BacktestingInstanceID}/Backtesting

--report et --report-json enregistrent également les rapports dans le chemin spécifié, en plus du dossier ci-dessus.

Comportement de l’API Algo dans cTrader CLI ¶

Certains membres de l’API cTrader Algo se comportent différemment lorsqu’un cBot s’exécute dans cTrader CLI, car aucune interface graphique n’est disponible.