Configurar o cTrader CLI¶

Este artigo explica como instalar o cTrader CLI, criar um ficheiro de credenciais e confirmar a ligação no Windows, macOS ou Linux, a partir de um terminal ou de um contentor Docker.

Pré-requisitos ¶

• Um cTrader ID com pelo menos uma conta de negociação.
• Um gestor de pacotes compatível: WinGet no Windows e Homebrew no macOS e Linux.
• Para cBots, .NET 8. Volte a compilar os cBots mais antigos na versão mais recente da aplicação cTrader para computador antes de os executar com o cTrader CLI.
• Para utilizar as skills, é necessário ter o Node.js 22.20.0 ou posterior.

Instalar com um gestor de pacotes ¶

A instalação através de um gestor de pacotes é o método recomendado. Descarrega a versão adequada ao seu sistema operativo e adiciona o comando ctrader-cli ao PATH, para que o possa executar a partir de qualquer pasta.

winget install Spotware.cTrader.CLI

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

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

Instalar com a imagem Docker ¶

O cTrader CLI é disponibilizado como uma imagem Docker para Linux, ideal para alojar cBots num VPS Linux, num servidor de elevado desempenho ou numa plataforma na nuvem. A imagem também funciona no Windows através do Docker Desktop com WSL.

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

O guia de execução de um cBot explica como montar pastas do anfitrião e transmitir a configuração através de variáveis de ambiente.

Instalar manualmente no Windows ¶

Se preferir não utilizar um gestor de pacotes no Windows, o executável ctrader-cli está incluído na aplicação cTrader para computador. Normalmente, encontra-se em:

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

Para executar o cTrader CLI a partir de qualquer pasta, adicione este diretório ao PATH:

1. Copie o caminho da pasta que contém ctrader-cli.
2. No menu Iniciar do Windows, procure Variáveis de ambiente e selecione Editar as variáveis de ambiente do sistema.
3. Na janela Propriedades do Sistema, selecione Variáveis de Ambiente.
4. Em Variáveis de utilizador, faça duplo clique em Path.
5. Selecione Novo, cole o caminho copiado e selecione OK em cada caixa de diálogo para guardar.

Verificar a instalação ¶

Após a instalação, confirme que o cTrader CLI está disponível. Nenhum dos dois comandos exige que inicie sessão.

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

Se o terminal indicar que o comando não foi encontrado, feche-o e abra-o novamente para carregar o PATH atualizado. Depois, tente outra vez.

Criar um ficheiro de credenciais ¶

A maioria dos comandos atua sobre uma conta, pelo que precisa de três valores: cTrader ID, palavra-passe e número da conta.

Por motivos de segurança, não introduza a palavra-passe do seu cTrader ID diretamente num comando. Guarde-a num ficheiro e indique esse ficheiro através de --pwd-file.

1. Abra um editor de texto simples, como o Bloco de Notas.
2. Introduza a palavra-passe do seu cTrader ID numa única linha, sem espaços no início ou no fim.
3. Guarde o ficheiro com a extensão .pwd ou .txt, por exemplo password.pwd.
4. Indique o ficheiro no comando: --pwd-file=C:/test/password.pwd.

Com o ficheiro de credenciais preparado, passe-o aos comandos através de uma das duas modalidades de autenticação.

Exemplo de execução com Docker ¶

Num contentor, os caminhos do anfitrião são montados através de --mount e os valores de configuração são transmitidos através de -e. Um exemplo breve que inicia um cBot num contentor:

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

Para consultar o guia completo de Docker, incluindo o significado de cada opção, veja como executar e gerir cBots.