FAQ¶

Notions de base ¶

Qu’est-ce que cTrader CLI ?

cTrader CLI est un outil en ligne de commande qui permet de gérer les comptes, les opérations de trading et les opérations algorithmiques directement depuis un terminal, sans ouvrir l’application de bureau cTrader. Vous saisissez des commandes pour vous connecter, consulter les données de marché, ouvrir et gérer des opérations de trading, ainsi que pour exécuter, backtester et optimiser des cBots.

De quoi ai-je besoin pour utiliser cTrader CLI ?

Il vous faut un cTrader ID associé à au moins un compte de trading, l’exécutable cTrader CLI accessible via votre PATH et un fichier d’identifiants cTrader ID.

Comment installer cTrader CLI ?

Utilisez un gestionnaire de paquets sous Windows, macOS ou Linux. Il télécharge la version adaptée à votre système d’exploitation. Une image Docker est également disponible. Sous Windows, l’exécutable est aussi fourni avec l’application de bureau cTrader.

cTrader CLI est-il gratuit ?

Oui. cTrader CLI est inclus dans cTrader. Vous devez disposer de votre propre cTrader ID, d’un fichier d’identifiants et d’un environnement d’hébergement si vous exécutez des cBots sans surveillance.

Agents IA ¶

Puis-je utiliser un assistant IA avec cTrader CLI ?

Oui. cTrader CLI permet deux approches : saisir et automatiser vous-même les commandes dans des scripts, ou décrire vos objectifs en langage naturel et demander à un assistant IA de proposer des commandes cTrader CLI à vérifier avant de les exécuter.

Dois-je installer une compétence pour utiliser un assistant IA ?

Non. Un assistant IA peut proposer des commandes cTrader CLI sans compétence installée. L’installation de compétences fournit à l’agent des références sur la syntaxe des commandes, leurs sorties et les règles de sécurité, afin d’améliorer la fiabilité des commandes générées.

Que dois-je vérifier avant d’autoriser une IA à exécuter une commande ?

Ne laissez pas un assistant IA lancer de lui-même la commande run, qui reste active longtemps. Vérifiez chaque commande générée par l’IA avant de l’exécuter sur un compte réel.

Authentification et identifiants ¶

Quelles sont les conventions d’authentification ?

cTrader CLI utilise deux conventions d’authentification. Le mode par lots nécessite --ctid et --pwd-file. Le mode interactif nécessite --ctid, --password ou --pwd-file, ainsi que -q. Les commandes par lots refusent --password, tandis que les commandes interactives acceptent les deux options de mot de passe.

Comment stocker mon mot de passe en toute sécurité ?

Enregistrez votre mot de passe cTID dans un fichier texte brut. Conservez ce fichier 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.

Quel courtier choisir si plusieurs comptes portent le même numéro ?

Ajoutez --broker=<broker-name> à la commande. Cette option permet de sélectionner le courtier lorsque des comptes de votre cTrader ID portent le même numéro chez différents courtiers.

Fonctionnalités ¶

Quelles opérations cTrader CLI prend-il en charge ?

Les opérations de cTrader CLI couvrent les comptes, le trading, les données de marché, l’historique, les indicateurs, les alertes, les cBots et les projets.

Quel fuseau horaire cTrader CLI utilise-t-il ?

Le UTC, pour toutes les dates et heures en entrée et en sortie. Par exemple, --from=2026-10-08 commence à 00:00 UTC le 8 octobre et les heures affichées dans la sortie peuvent prendre la forme 2026-10-08T14:05:00.000Z. Seule exception : l’heure utilisée dans un cBot en cours d’exécution dépend de son paramètre TimeZone.

Puis-je définir plusieurs niveaux de take profit pour un trade ?

Non. cTrader CLI ne prend actuellement en charge qu’un seul niveau de take profit par trade.

Puis-je définir un stop loss suiveur ou une protection au seuil de rentabilité ?

Non. Aucune de ces deux protections n’est actuellement disponible dans cTrader CLI.

Puis-je définir une date d’expiration pour un ordre en cours ?

Non. L’expiration des ordres (good till date) n’est actuellement pas disponible dans cTrader CLI.

Puis-je définir un écart de marché ?

Non. L’écart de marché n’est actuellement pas disponible dans cTrader CLI. L’option --limit-range s’applique aux ordres stop-limit.

Puis-je choisir une méthode de déclenchement des ordres stop ?

Non. Le choix de la méthode de déclenchement des ordres stop n’est actuellement pas disponible dans cTrader CLI.

Comment afficher tous les identifiants de période acceptés par la CLI ?

Exécutez ctrader-cli periods. Cette commande affiche tous les identifiants acceptés par --period et --timeframe. La casse des caractères n’a aucune importance.

Comment exécuter un cBot sur un VPS ou un serveur cloud ?

Exécutez le cBot dans l’image Docker de cTrader CLI, en montant le dossier hôte et en transmettant les paramètres de configuration par des variables d’environnement.

Cycle de vie des cBots ¶

De quelle version de .NET mon cBot a-t-il besoin ?

Le fichier .algo doit être compilé pour .NET 8. Recompilez les anciens cBots dans la dernière version de l’application de bureau cTrader.

Comment démarrer un cBot depuis le terminal ?

Exécutez ctrader-cli run <path-to-algo-file> --account=<account-id> --symbol=<symbol> --period=<period>. Cette commande reste active. Utilisez --exit-on-stop si vous souhaitez que le processus cTrader CLI se termine lorsque le cBot s’arrête.

Comment arrêter tous les cBots en cours d’exécution en une seule fois ?

Ouvrez le shell interactif avec ctrader-cli, connectez-vous, puis exécutez stop all yes. Le processus cTrader CLI se termine lorsque la dernière instance s’arrête.

Comment transmettre des paramètres à un cBot ?

Transmettez les paramètres du cBot de trois façons : conservez les valeurs par défaut du cBot, remplacez une ou deux valeurs avec --ParameterName=value dans la ligne de commande, ou passez un fichier .cbotset enregistré comme deuxième argument positionnel. Les fichiers .cbotset proviennent de l’application de bureau cTrader et permettent de réutiliser les mêmes valeurs à chaque exécution.

Comment optimiser les paramètres d’un cBot ?

Pour optimiser un cBot, exécutez ctrader-cli optimize <path-to-algo-file> --params=<path-to-params-file>. Le fichier de paramètres JSON indique les paramètres à faire varier et ceux à garder fixes. Utilisez --criteria pour les classements standard ou --fitness pour la méthode GetFitness propre au cBot.