Configurare cTrader CLI¶

Questo articolo spiega come installare cTrader CLI, creare un file delle credenziali e verificare la connessione su Windows, macOS o Linux, da un terminale o un container Docker.

Prerequisiti ¶

Un cTrader ID con almeno un conto di trading.
Un gestore di pacchetti supportato: WinGet su Windows e Homebrew su macOS e Linux.
Per i cBot, .NET 8. Prima di eseguire i cBot più vecchi con cTrader CLI, ricompilali nell’ultima versione dell’applicazione desktop cTrader.
Per utilizzare le skill, è necessario Node.js 22.20.0 o versione successiva.

Installare con un gestore di pacchetti ¶

L’installazione tramite un gestore di pacchetti è il metodo consigliato. Scarica la build corretta per il tuo sistema operativo e aggiunge il comando ctrader-cli al PATH, permettendoti di eseguirlo da qualsiasi cartella.

WindowsmacOSLinux

Apri Windows PowerShell come amministratore ed esegui:

winget install Spotware.cTrader.CLI

Apri un terminale ed esegui:

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

Se Homebrew non è installato, segui prima le istruzioni sul sito di Homebrew.

Apri un terminale ed esegui:

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

Se Homebrew non è installato, segui prima le istruzioni sul sito di Homebrew.

Avvertenza

Installa cTrader CLI solo usando gli identificativi ufficiali dei pacchetti Spotware indicati sopra. Installare software da fonti non verificate può mettere a rischio le credenziali e i fondi.

Installare con l’immagine Docker ¶

cTrader CLI è distribuito come immagine Docker Linux, ideale per ospitare cBot su un VPS Linux, un server ad alte prestazioni o una piattaforma cloud. L’immagine funziona anche su Windows tramite Docker Desktop con WSL.

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

La guida all’esecuzione dei cBot spiega come montare le cartelle dell’host e trasmettere la configurazione tramite variabili d’ambiente.

Suggerimento

cTrader CLI è incluso nell’applicazione desktop cTrader, quindi puoi avviare un cBot in un processo esterno senza un’installazione separata.

Installare manualmente su Windows ¶

Se preferisci non utilizzare un gestore di pacchetti su Windows, l’eseguibile ctrader-cli è già incluso nell’applicazione desktop cTrader. Di solito si trova in:

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

Per eseguire cTrader CLI da qualsiasi cartella, aggiungi questa directory al PATH:

Copia il percorso della cartella che contiene ctrader-cli.
Nel menu Start di Windows cerca Variabili d’ambiente, quindi seleziona Modifica le variabili d’ambiente di sistema.
Nella finestra Proprietà del sistema, seleziona Variabili d’ambiente.
In Variabili utente, fai doppio clic su Path.
Seleziona Nuovo, incolla il percorso copiato e conferma con OK in ogni finestra di dialogo per salvare.

Nota

Dopo aver aggiunto la cartella al PATH, puoi eseguire ctrader-cli seguito da qualsiasi comando da qualunque posizione.

Verificare l’installazione ¶

Dopo l’installazione, verifica che cTrader CLI sia disponibile. Nessuno dei due comandi richiede l’accesso.

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

Se il terminale segnala che il comando non è stato trovato, chiudilo e riaprilo per caricare il PATH aggiornato, quindi riprova.

Creare un file delle credenziali ¶

La maggior parte dei comandi opera su un conto e richiede quindi tre valori: un cTrader ID, una password e un numero di conto.

Dettaglio	Opzione	Descrizione
cTrader ID	`--ctid` o `-c`	Nome utente o indirizzo email del cTID
Password	`--pwd-file`	Percorso di un file contenente la password del cTID
Conto	`--account` o `-a`	Numero del conto di trading

Per motivi di sicurezza, non digitare la password del tuo cTrader ID direttamente in un comando. Salvala in un file e indica quel file con --pwd-file.

Apri un editor di testo semplice, ad esempio Blocco note.
Digita la password del tuo cTrader ID su un’unica riga, senza spazi iniziali o finali.
Salva il file con estensione .pwd o .txt, ad esempio password.pwd.
Indica il file nel comando: --pwd-file=C:/test/password.pwd.

Una volta pronto il file delle credenziali, passalo ai comandi seguendo una delle due modalità di autenticazione.

Avvertenza

Un file delle password conserva la password in testo non crittografato. Conservalo fuori dalle cartelle condivise o soggette a controllo versione, limita chi può leggerlo ed eliminalo quando non serve più.

Esempio di esecuzione con Docker ¶

In un container, i percorsi dell’host vengono mappati con --mount e le impostazioni di configurazione vengono passate tramite -e. Ecco un breve esempio di avvio di un cBot in un container:

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

Per la guida Docker completa, compreso il significato di ogni opzione, consulta come eseguire e gestire i cBot.