Perguntas frequentes¶

Conceitos básicos ¶

O que é o cTrader CLI?

O cTrader CLI é uma ferramenta de linha de comandos que permite gerir contas, operações de negociação e operações algorítmicas diretamente a partir de um terminal, sem abrir a aplicação cTrader para computador. Introduza comandos para iniciar sessão, consultar dados de mercado, abrir e gerir operações, bem como executar, testar com dados históricos e otimizar cBots.

De que preciso para utilizar o cTrader CLI?

Precisa de um cTrader ID com pelo menos uma conta de negociação, do executável cTrader CLI disponível no seu PATH e de um ficheiro de credenciais do cTrader ID.

Como instalo o cTrader CLI?

Utilize um gestor de pacotes no Windows, macOS ou Linux. O gestor descarrega a versão adequada ao seu sistema operativo. Também está disponível uma imagem Docker e, no Windows, o executável está incluído na aplicação cTrader para computador.

O cTrader CLI é gratuito?

Sim. O cTrader CLI está incluído no cTrader. Deve utilizar o seu próprio cTrader ID, um ficheiro de credenciais e um ambiente de alojamento, caso execute cBots sem supervisão.

Agentes de IA ¶

Posso utilizar um assistente de IA com o cTrader CLI?

Sim. O cTrader CLI permite dois métodos de trabalho: introduzir comandos e escrever scripts por conta própria ou descrever os seus objetivos em linguagem natural e pedir a um assistente de IA que prepare comandos do cTrader CLI para rever e executar.

Preciso de instalar uma skill para utilizar um assistente de IA?

Não. Um assistente de IA pode preparar comandos do cTrader CLI sem uma skill instalada. A instalação de skills fornece ao agente material de referência sobre a sintaxe dos comandos, os resultados e as regras de segurança, tornando mais fiáveis os comandos gerados.

O que devo verificar antes de permitir que uma IA execute um comando?

Não permita que um assistente de IA inicie autonomamente o comando de execução prolongada run. Reveja todos os comandos gerados por IA antes de os executar numa conta real.

Autenticação e credenciais ¶

Quais são as modalidades de autenticação?

O cTrader CLI utiliza duas modalidades de autenticação. Os comandos em lote exigem --ctid e --pwd-file. Os comandos interativos exigem --ctid, --password ou --pwd-file e -q. Os comandos em lote não aceitam --password; os comandos interativos aceitam ambas as opções de palavra-passe.

Como posso guardar a minha palavra-passe em segurança?

Guarde a palavra-passe do cTID num ficheiro de texto simples. Mantenha o ficheiro fora de pastas partilhadas ou sujeitas a controlo de versões, restrinja as permissões de leitura e elimine-o quando deixar de ser necessário.

Que corretora devo selecionar se várias contas tiverem o mesmo número?

Adicione --broker=<broker-name> a qualquer comando. Esta opção seleciona a corretora quando o seu cTrader ID tem contas com o mesmo número em corretoras diferentes.

Fluxos de trabalho ¶

Que operações são suportadas pelo cTrader CLI?

As operações do cTrader CLI abrangem contas, negociação, dados de mercado, histórico, indicadores, alertas, cBots e projetos.

Que fuso horário utiliza o cTrader CLI?

UTC, para todas as datas e horas de entrada e saída. Por exemplo, --from=2026-10-08 começa às 00:00 UTC de 8 de outubro e os resultados apresentam horas como 2026-10-08T14:05:00.000Z. A única exceção é a hora utilizada dentro de um cBot em execução, que segue a configuração TimeZone do próprio cBot.

Posso definir mais de um nível de take profit numa operação?

Não. Atualmente, o cTrader CLI só suporta um nível de take profit por operação.

Posso definir um trailing stop loss ou proteção de break-even?

Não. Nenhuma destas funcionalidades está atualmente disponível no cTrader CLI.

Posso definir uma data de validade para uma ordem pendente?

Não. A validade das ordens (good till date) não está atualmente disponível no cTrader CLI.

Posso definir um intervalo de mercado?

Não. O intervalo de mercado não está atualmente disponível no cTrader CLI. A opção --limit-range aplica-se a ordens stop-limit.

Posso escolher o método de ativação do stop?

Não. A seleção do método de ativação do stop não está atualmente disponível no cTrader CLI.

Como posso listar todos os identificadores de período aceites pela CLI?

Execute ctrader-cli periods. O comando apresenta todos os identificadores aceites por --period e --timeframe. A interpretação não distingue maiúsculas de minúsculas.

Como posso executar um cBot num VPS ou servidor na nuvem?

Execute o cBot na imagem Docker do cTrader CLI, montando a pasta do anfitrião e passando os valores de configuração através de variáveis de ambiente.

Ciclo de vida dos cBots ¶

De que versão do .NET precisa o meu cBot?

O ficheiro .algo tem de ser compilado para .NET 8. Volte a compilar os cBots mais antigos na versão mais recente da aplicação cTrader para computador.

Como inicio um cBot a partir do terminal?

Execute ctrader-cli run <path-to-algo-file> --account=<account-id> --symbol=<symbol> --period=<period>. O comando permanece em execução. Utilize --exit-on-stop se quiser que o processo cTrader CLI termine quando o cBot parar.

Como paro todos os cBots em execução de uma só vez?

Abra a shell interativa com ctrader-cli, inicie sessão e execute stop all yes. O processo cTrader CLI termina quando a última instância parar.

Como passo parâmetros a um cBot?

Pode passar os parâmetros do cBot de três formas: utilizar os valores predefinidos, substituir um ou dois valores através de --ParameterName=value na linha de comandos ou passar um ficheiro .cbotset guardado como segundo argumento posicional. Os ficheiros .cbotset são provenientes da aplicação cTrader para computador e permitem reutilizar os valores entre execuções.

Como otimizo os parâmetros de um cBot?

Para otimizar um cBot, execute ctrader-cli optimize <path-to-algo-file> --params=<path-to-params-file>. O ficheiro de parâmetros JSON indica quais os parâmetros que devem variar e quais devem permanecer fixos. Utilize --criteria para classificações padrão ou --fitness para o método GetFitness do próprio cBot.