FAQ¶

Nozioni di base ¶

Che cos’è cTrader CLI?

cTrader CLI è uno strumento da riga di comando che consente di gestire conti, operazioni di trading e operazioni algoritmiche direttamente dal terminale, senza aprire l’applicazione desktop cTrader. Puoi digitare comandi per accedere, consultare i dati di mercato, aprire e gestire operazioni di trading, nonché eseguire, sottoporre a backtesting e ottimizzare i cBot.

Di cosa ho bisogno per usare cTrader CLI?

Ti servono un cTrader ID con almeno un conto di trading, l’eseguibile cTrader CLI disponibile nel PATH e un file delle credenziali del cTrader ID.

Come si installa cTrader CLI?

Utilizza un gestore di pacchetti su Windows, macOS o Linux. Il gestore scarica la versione corretta per il tuo sistema operativo. È disponibile anche un’immagine Docker e, su Windows, l’eseguibile viene fornito con l’applicazione desktop cTrader.

cTrader CLI è gratuito?

Sì. cTrader CLI è incluso in cTrader. Devi fornire il tuo cTrader ID, un file delle credenziali e un ambiente di hosting se esegui cBot senza supervisione.

Agenti IA ¶

Posso utilizzare un assistente IA con cTrader CLI?

Sì. cTrader CLI supporta due modalità: digitare i comandi e creare gli script autonomamente oppure descrivere gli obiettivi in linguaggio naturale e chiedere a un assistente IA di proporre comandi cTrader CLI da controllare ed eseguire.

Devo installare una skill per usare un assistente IA?

No. Un assistente IA può proporre comandi cTrader CLI anche senza una skill. Installando le skill, fornisci all’agente materiale di riferimento su sintassi dei comandi, output e regole di sicurezza, rendendo più affidabili i comandi generati.

Che cosa devo controllare prima di consentire all’IA di eseguire un comando?

Non lasciare che un assistente IA avvii autonomamente il comando a esecuzione prolungata run e controlla ogni comando generato dall’IA prima di eseguirlo su un conto live.

Autenticazione e credenziali ¶

Quali sono le modalità di autenticazione?

cTrader CLI utilizza due modalità di autenticazione. Per i comandi batch servono --ctid e --pwd-file; per quelli interattivi servono --ctid, --password oppure --pwd-file, e -q. I comandi batch non accettano --password; quelli interattivi accettano entrambe le opzioni per la password.

Come posso conservare la password in sicurezza?

Salva la password del cTID in un file di testo semplice. Conserva il file fuori dalle cartelle condivise o soggette a controllo versione, limita l’accesso in lettura ed eliminalo quando non serve più.

Quale broker devo scegliere se i conti hanno lo stesso numero?

Aggiungi --broker=<broker-name> a qualsiasi comando. Questa opzione seleziona il broker quando al tuo cTrader ID sono associati conti con lo stesso numero presso broker diversi.

Flussi di lavoro ¶

Quali operazioni supporta cTrader CLI?

Le operazioni di cTrader CLI comprendono conti, trading, dati di mercato, cronologia, indicatori, avvisi, cBot e progetti.

Quale fuso orario utilizza cTrader CLI?

UTC per tutte le date e gli orari in input e output. Ad esempio, --from=2026-10-08 parte dalle 00:00 UTC dell’8 ottobre e l’output mostra orari come 2026-10-08T14:05:00.000Z. L’unica eccezione è l’orario all’interno di un cBot in esecuzione, che segue l’impostazione TimeZone del cBot.

Posso impostare più livelli di take profit per un’operazione?

No. Attualmente cTrader CLI supporta un solo livello di take profit per operazione.

Posso impostare un trailing stop loss o la protezione di pareggio?

No. Attualmente nessuna delle due funzioni è disponibile in cTrader CLI.

Posso impostare una data di scadenza per un ordine in sospeso?

No. La scadenza degli ordini (good till date) non è attualmente disponibile in cTrader CLI.

Posso impostare un intervallo di mercato?

No. Attualmente l’intervallo di mercato non è disponibile in cTrader CLI. L’opzione --limit-range si applica agli ordini stop limit.

Posso scegliere un metodo di attivazione dello stop?

No. Attualmente cTrader CLI non consente di scegliere il metodo di attivazione dello stop.

Come posso visualizzare tutti i token di periodo accettati dalla CLI?

Esegui ctrader-cli periods. Il comando mostra tutti i token accettati da --period e --timeframe. Non viene fatta distinzione tra maiuscole e minuscole.

Come posso eseguire un cBot su un VPS o su un server cloud?

Esegui il cBot nell’immagine Docker di cTrader CLI, montando la cartella dell’host e passando le impostazioni tramite variabili d’ambiente.

Ciclo di vita dei cBot ¶

Di quale versione di .NET ha bisogno il mio cBot?

Il file .algo deve essere compilato per .NET 8. Ricompila i cBot più vecchi nell’ultima versione dell’applicazione desktop cTrader.

Come si avvia un cBot dal terminale?

Esegui ctrader-cli run <path-to-algo-file> --account=<account-id> --symbol=<symbol> --period=<period>. Il comando rimane in esecuzione: usa --exit-on-stop se vuoi che il processo cTrader CLI termini quando il cBot si arresta.

Come posso arrestare tutti i cBot in esecuzione contemporaneamente?

Apri la shell interattiva con ctrader-cli, effettua l’accesso ed esegui stop all yes. Il processo cTrader CLI termina quando si arresta l’ultima istanza.

Come posso passare i parametri a un cBot?

Puoi passare i parametri del cBot in tre modi: utilizzare i valori predefiniti, sostituire uno o due valori con --ParameterName=value nella riga di comando oppure passare un file .cbotset salvato come secondo argomento posizionale. I file .cbotset vengono creati nell’applicazione desktop cTrader e consentono di riutilizzare gli stessi valori tra un’esecuzione e l’altra.

Come posso ottimizzare i parametri di un cBot?

Per ottimizzare un cBot, esegui ctrader-cli optimize <path-to-algo-file> --params=<path-to-params-file>: il file dei parametri JSON specifica quali parametri variare e quali mantenere fissi. Utilizza --criteria per le classifiche standard oppure --fitness per il metodo GetFitness del cBot.