Configurer cTrader CLI¶

Cet article explique comment installer cTrader CLI, créer un fichier d’identifiants et vérifier la connexion sous Windows, macOS ou Linux, depuis un terminal ou un conteneur Docker.

Prérequis ¶

Un cTrader ID associé à au moins un compte de trading.
Un gestionnaire de paquets compatible : WinGet sous Windows et Homebrew sous macOS et Linux.
Pour les cBots, .NET 8. Recompilez les anciens cBots dans la dernière version de l’application de bureau cTrader avant de les exécuter avec cTrader CLI.
Pour utiliser les compétences, Node.js version 22.20.0 ou ultérieure est requis.

Installer avec un gestionnaire de paquets ¶

L’installation via un gestionnaire de paquets est la méthode recommandée. Elle télécharge la version adaptée à votre système d’exploitation et ajoute la commande ctrader-cli à votre PATH, afin que vous puissiez l’exécuter depuis n’importe quel dossier.

WindowsmacOSLinux

Ouvrez Windows PowerShell en tant qu’administrateur et exécutez :

winget install Spotware.cTrader.CLI

Ouvrez un terminal et exécutez :

brew tap spotware/tap https://github.com/spotware/homebrew-tap
brew install spotware/tap/ctrader-cli

Si Homebrew n’est pas installé, suivez d’abord les instructions du site de Homebrew.

Ouvrez un terminal et exécutez :

brew tap spotware/tap https://github.com/spotware/homebrew-tap
brew install spotware/tap/ctrader-cli

Si Homebrew n’est pas installé, suivez d’abord les instructions du site de Homebrew.

Avertissement

Installez cTrader CLI uniquement à partir des identifiants de paquets officiels Spotware indiqués ci-dessus. Une installation provenant d’une source non vérifiée peut compromettre vos identifiants et vos fonds.

Installer avec l’image Docker ¶

cTrader CLI est distribué sous forme d’image Docker Linux, pratique pour héberger des cBots sur un VPS Linux, un serveur haute performance ou une plateforme cloud. L’image fonctionne également sous Windows via Docker Desktop avec WSL.

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

Le guide d’exécution d’un cBot explique comment monter les dossiers de l’hôte et transmettre la configuration au moyen de variables d’environnement.

Astuce

cTrader CLI est fourni avec l’application de bureau cTrader. Vous pouvez donc lancer un cBot dans un processus externe sans installation distincte.

Installer manuellement sous Windows ¶

Si vous préférez ne pas utiliser de gestionnaire de paquets sous Windows, l’exécutable ctrader-cli est inclus dans l’application de bureau cTrader. Il se trouve généralement à l’emplacement suivant :

C:\Users\{username}\AppData\Local\Spotware\cTrader\{installationId}

Pour exécuter cTrader CLI depuis n’importe quel dossier, ajoutez ce répertoire à votre PATH :

Copiez le chemin du dossier contenant ctrader-cli.
Dans le menu Démarrer de Windows, recherchez Variables d’environnement, puis sélectionnez Modifier les variables d’environnement système.
Dans la fenêtre Propriétés système, sélectionnez Variables d’environnement.
Sous Variables utilisateur, double-cliquez sur Path.
Sélectionnez Nouveau, collez le chemin copié, puis cliquez sur OK dans chaque boîte de dialogue pour enregistrer.

Remarque

Après avoir ajouté le dossier à PATH, vous pouvez exécuter ctrader-cli suivi de n’importe quelle commande, depuis n’importe quel emplacement.

Vérifier l’installation ¶

Après l’installation, vérifiez que cTrader CLI est disponible. Aucune des deux commandes ne nécessite de connexion.

ctrader-cli --version
ctrader-cli --help

Si votre terminal indique que la commande est introuvable, fermez-le puis rouvrez-le pour qu’il prenne en compte le PATH mis à jour, et réessayez.

Créer un fichier d’identifiants ¶

La plupart des commandes agissent sur un compte. Elles nécessitent donc trois valeurs : un cTrader ID, un mot de passe et un numéro de compte.

Élément	Option	Description
cTrader ID	`--ctid` ou `-c`	Nom d’utilisateur ou adresse e-mail du cTID
Mot de passe	`--pwd-file`	Chemin d’accès à un fichier contenant le mot de passe du cTID
Compte	`--account` ou `-a`	Numéro du compte de trading

Pour des raisons de sécurité, ne saisissez pas directement votre mot de passe cTrader ID dans une commande. Enregistrez-le dans un fichier et indiquez ce fichier avec --pwd-file.

Ouvrez un éditeur de texte brut, par exemple le Bloc-notes.
Saisissez le mot de passe de votre cTrader ID sur une seule ligne, sans espace au début ni à la fin.
Enregistrez le fichier avec l’extension .pwd ou .txt, par exemple password.pwd.
Indiquez le fichier dans votre commande : --pwd-file=C:/test/password.pwd.

Une fois le fichier d’identifiants prêt, transmettez-le aux commandes en suivant l’une des deux méthodes d’authentification.

Avertissement

Un fichier de mots de passe stocke votre mot de passe en texte clair. Conservez-le hors des dossiers partagés ou suivis par un système de gestion de versions, limitez les droits de lecture et supprimez-le lorsqu’il n’est plus nécessaire.

Exemple d’exécution Docker ¶

Dans un conteneur, les chemins de l’hôte sont montés à l’aide de --mount et les valeurs de configuration sont transmises avec -e. Voici un bref exemple de démarrage d’un cBot dans un conteneur :

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

Pour consulter le guide Docker complet, y compris le rôle de chaque option, découvrez comment exécuter et gérer des cBots.