Configurar cTrader CLI¶

Este artículo explica cómo instalar cTrader CLI, crear un archivo de credenciales y comprobar la conexión en Windows, macOS o Linux, desde un terminal o un contenedor Docker.

Requisitos previos ¶

Un cTrader ID con al menos una cuenta de operaciones.
Un gestor de paquetes compatible: WinGet en Windows y Homebrew en macOS y Linux.
Para los cBots, .NET 8. Vuelve a compilar los cBots antiguos en la versión más reciente de la aplicación de escritorio de cTrader antes de ejecutarlos con cTrader CLI.
Para utilizar las habilidades, necesitas Node.js 22.20.0 o posterior.

Instalar con un gestor de paquetes ¶

La opción recomendada es instalar cTrader CLI mediante un gestor de paquetes. Descarga la versión adecuada para tu sistema operativo y añade el comando ctrader-cli a tu PATH para que puedas ejecutarlo desde cualquier carpeta.

WindowsmacOSLinux

Abre Windows PowerShell como administrador y ejecuta:

winget install Spotware.cTrader.CLI

Abre un terminal y ejecuta:

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

Si no tienes Homebrew instalado, sigue primero las instrucciones del sitio web de Homebrew.

Abre un terminal y ejecuta:

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

Si no tienes Homebrew instalado, sigue primero las instrucciones del sitio web de Homebrew.

Advertencia

Instala cTrader CLI únicamente mediante los identificadores oficiales de paquetes de Spotware indicados arriba. Instalarlo desde una fuente no verificada puede poner en riesgo tus credenciales y fondos.

Instalar mediante la imagen Docker ¶

cTrader CLI se distribuye como una imagen Docker para Linux, útil para alojar cBots en un VPS Linux, un servidor de alto rendimiento o una plataforma en la nube. La imagen también funciona en Windows mediante Docker Desktop con WSL.

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

La guía para ejecutar un cBot explica cómo montar carpetas del equipo anfitrión y pasar la configuración mediante variables de entorno.

Consejo

cTrader CLI se incluye con la aplicación de escritorio de cTrader, así que puedes iniciar un cBot en un proceso externo sin instalarlo por separado.

Instalar manualmente en Windows ¶

Si prefieres no utilizar un gestor de paquetes en Windows, el ejecutable ctrader-cli está incluido en la aplicación de escritorio de cTrader. Normalmente se encuentra en:

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

Para ejecutar cTrader CLI desde cualquier carpeta, añade este directorio a tu PATH:

Copia la ruta de la carpeta que contiene ctrader-cli.
Busca Variables de entorno en el menú Inicio de Windows y selecciona Editar las variables de entorno del sistema.
En la ventana Propiedades del sistema, selecciona Variables de entorno.
En Variables de usuario, haz doble clic en Path.
Selecciona Nuevo, pega la ruta copiada y pulsa Aceptar en cada cuadro de diálogo para guardar.

Nota

Una vez añadida la carpeta a PATH, podrás ejecutar ctrader-cli seguido de cualquier comando desde cualquier ubicación.

Comprobar la instalación ¶

Después de instalarlo, comprueba que cTrader CLI esté disponible. Ninguno de los dos comandos requiere iniciar sesión.

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

Si el terminal indica que no encuentra el comando, ciérralo y vuelve a abrirlo para que reconozca el PATH actualizado. Después, inténtalo de nuevo.

Crear un archivo de credenciales ¶

La mayoría de los comandos actúan sobre una cuenta, por lo que necesitan tres datos: un cTrader ID, una contraseña y un número de cuenta.

Dato	Opción	Descripción
cTrader ID	`--ctid` o `-c`	Nombre de usuario o correo electrónico del cTID
Contraseña	`--pwd-file`	Ruta a un archivo que contiene la contraseña del cTID
Cuenta	`--account` o `-a`	Número de cuenta de operaciones

Por seguridad, no escribas la contraseña de tu cTrader ID directamente en un comando. Guárdala en un archivo e indica su ruta mediante --pwd-file.

Abre un editor de texto sin formato, como el Bloc de notas.
Escribe la contraseña de tu cTrader ID en una sola línea, sin espacios al principio ni al final.
Guarda el archivo con la extensión .pwd o .txt, por ejemplo password.pwd.
Indica el archivo en el comando: --pwd-file=C:/test/password.pwd.

Cuando tengas preparado el archivo de credenciales, pásalo a los comandos siguiendo una de las dos modalidades de autenticación.

Advertencia

Un archivo de contraseñas almacena tu contraseña en texto sin cifrar. Guárdalo fuera de carpetas compartidas o sometidas a control de versiones, limita quién puede leerlo y elimínalo cuando ya no lo necesites.

Ejemplo de ejecución con Docker ¶

En un contenedor, las rutas del equipo anfitrión se montan mediante --mount y los valores de configuración se transmiten mediante -e. Este ejemplo breve inicia un cBot dentro de un contenedor:

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 la guía completa de Docker, incluida la explicación de cada opción, descubre cómo ejecutar y gestionar cBots.