Ir para o conteúdo

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. Pode introduzir comandos para iniciar sessão, consultar dados de mercado, executar e gerir negociações, bem como executar cBots, realizar testes de verificação e otimizar cBots.

Descubra o cTrader CLI em apenas um minuto!

Existem duas formas principais de utilizar o cTrader CLI. Pode introduzir comandos e automatizá-los através de scripts, ou deixar que um agente de IA converta os seus pedidos em linguagem natural em comandos do cTrader CLI, para que os possa rever e executar. Em ambos os casos, pode:

  • Ligar o cTrader a agentes de IA que criam comandos CLI para rever e executar.
  • Instalar skills que ensinam o seu agente de IA a utilizar corretamente o cTrader CLI.
  • Executar cBots no Windows, macOS e Linux sem manter a aplicação cTrader para computador aberta, poupando memória RAM e recursos do processador.
  • Alojar cBots num VPS Linux de baixo custo ou num servidor na nuvem, em vez de utilizar um computador que consome mais recursos.
  • Consultar dados de contas, preços e histórico, bem como colocar e gerir ordens e posições através de scripts e fluxos de trabalho automatizados.

Nota

O cTrader CLI executa cBots no seu computador ou servidor. Isto é diferente de executar cBots na nuvem, em que o cTrader os aloja nos seus servidores, sem ser necessário manter processos em execução no seu computador ou servidor.

Cenários de utilização do cTrader CLI

O cTrader CLI suporta dois cenários de utilização principais. Ambos utilizam comandos escritos em vez de uma interface gráfica, mas destinam-se a objetivos diferentes.

Aspeto do cenário Agente de IA, sem interface Alojamento próprio num VPS ou na nuvem
Objetivo Utilizar o cTrader através de um assistente de IA, sem recorrer a um terminal nem a uma interface gráfica. Executar cBots continuamente num servidor gerido por si, com a aplicação para computador fechada.
Utilizador habitual Um utilizador que descreve os seus objetivos em linguagem natural; um assistente de IA prepara os comandos para que os possa rever e executar. Um trader ou operador familiarizado com o terminal, que introduz comandos ou os executa através de scripts.
Origem dos comandos Gerados pela IA a partir de um pedido em linguagem natural ou de um fluxo de trabalho de um agente baseado em scripts. Introduzidos no terminal ou executados a partir de um script, de uma tarefa cron ou de docker run.
Tratamento dos resultados A IA interpreta os dados JSON e transforma-os numa resposta ou no prompt seguinte. Dados JSON enviados para stdout, redirecionados para ficheiros ou encaminhados para outras ferramentas através de um pipe.
Comandos de longa duração O agente de IA não deve iniciar run autonomamente. Pode monitorizar cbots e consultar em segurança os preços em tempo real apresentados por price, mas qualquer comando que inicie, configure ou pare um cBot deve ser revisto antes de ser executado. run inicia um processo de longa duração que requer um supervisor de processos, como o systemd ou o Docker, ou a opção --exit-on-stop; todos os outros comandos CLI são chamadas únicas que devolvem um resultado e terminam.

Nota

Em ambos os cenários, é responsável por disponibilizar e gerir o servidor ou a estação de trabalho. O cTrader CLI não inclui um serviço de alojamento gerido.

Configurar o cTrader CLI

cTrader CLI vs. servidores cTrader MCP

Tanto o cTrader CLI como os servidores cTrader MCP permitem utilizar o cTrader sem interagir manualmente com a sua interface, mas funcionam de formas diferentes. Consulte a tabela seguinte para escolher a opção mais adequada ao seu fluxo de trabalho.

cTrader CLI Servidores cTrader MCP
Como interage Introduz comandos num terminal ou pede à IA que os prepare para os rever e executar. Descreve o que pretende fazer em linguagem natural e um agente de IA trata da execução.
É necessária a aplicação cTrader? Não. Funciona de forma independente a partir de um terminal, VPS ou contentor. É necessário manter uma instância do cTrader aberta em segundo plano: a aplicação para computador no Windows ou macOS para utilização local, ou uma sessão do cTrader Web para utilização remota.
Onde aparecem os resultados das ações Apenas no terminal, sob a forma de texto e JSON; não são apresentados na interface do cTrader. Na interface do cTrader, juntamente com a vista habitual da plataforma.
Mais adequado para Automação repetível através de scripts e alojamento de cBots num servidor. Negociação e análise através de conversas com um assistente de IA, bem como perguntas pontuais.

Dica

Escolha o cTrader CLI quando a repetibilidade e o controlo preciso forem as suas principais prioridades. Escolha os servidores cTrader MCP quando privilegiar a interação por conversa com um agente de IA.

Explore o cTrader CLI

Operações

O cTrader CLI agrupa os comandos por tarefa. A tabela seguinte apresenta as operações disponíveis. A sintaxe detalhada, as opções e os exemplos de cada comando estão disponíveis na documentação de referência da CLI.

Operação cTrader CLI
Listar contas e consultar as estatísticas das contas ✅
Listar os símbolos disponíveis e consultar as respetivas sessões e condições de negociação ✅
Consultar preços em tempo real e velas históricas ✅
Colocar ordens de mercado, ordens de limite, ordens stop e ordens de stop-limit com níveis fixos de stop loss e take profit; alterar e cancelar ordens pendentes e listar as ordens existentes ✅
Alterar os níveis fixos de stop loss e take profit, fechar posições total ou parcialmente e listar as posições abertas ✅
Consultar transações, o histórico de ordens concluídas e a exposição atual ✅
Calcular os valores atuais e históricos dos indicadores e listar os indicadores disponíveis ✅
Criar, eliminar e listar alertas de preço ✅
Executar e parar cBots, realizar testes de verificação e consultar os metadados dos cBots ✅
Otimizar cBots ✅
Gerar a estrutura inicial e compilar projetos de cBots, indicadores e plugins ✅

Aviso

O cTrader CLI é uma ferramenta de negociação e automação. Não presta aconselhamento financeiro, de investimento, jurídico ou fiscal. Os comandos que colocam ou alteram ordens podem desencadear negociações reais e provocar perdas. Verifique cada comando antes de o executar, teste-o primeiro numa conta demo e proteja as suas credenciais.