Preguntas frecuentes¶

Conceptos básicos ¶

¿Qué es cTrader CLI?

cTrader CLI es una herramienta de línea de comandos que permite gestionar cuentas, operaciones de trading y operaciones algorítmicas directamente desde un terminal, sin abrir la aplicación de escritorio de cTrader. Puedes introducir comandos para iniciar sesión, consultar datos de mercado, abrir y gestionar operaciones, así como ejecutar cBots, realizar backtesting y optimizarlos.

¿Qué necesito para utilizar cTrader CLI?

Necesitas un cTrader ID con al menos una cuenta de operaciones, el ejecutable de cTrader CLI disponible en tu PATH y un archivo de credenciales de cTrader ID.

¿Cómo instalo cTrader CLI?

Utiliza un gestor de paquetes en Windows, macOS o Linux. Este descargará la versión adecuada para tu sistema operativo. También hay una imagen Docker disponible y, en Windows, el ejecutable se incluye en la aplicación de escritorio de cTrader.

¿Es gratuito cTrader CLI?

Sí. cTrader CLI está incluido en cTrader. Debes aportar tu propio cTrader ID, un archivo de credenciales y un entorno de alojamiento si vas a ejecutar cBots sin supervisión.

Agentes de IA ¶

¿Puedo utilizar un asistente de IA con cTrader CLI?

Sí. cTrader CLI permite dos formas de trabajo: introducir comandos y crear scripts por tu cuenta, o describir tus objetivos en lenguaje natural y pedir a un asistente de IA que proponga comandos de cTrader CLI para revisarlos y ejecutarlos.

¿Necesito instalar una habilidad para utilizar un asistente de IA?

No. Un asistente de IA puede proponer comandos de cTrader CLI sin tener instalada ninguna habilidad. Al instalar habilidades, proporcionas al agente material de referencia sobre la sintaxis de los comandos, sus resultados y las normas de seguridad, lo que mejora la fiabilidad de los comandos generados.

¿Qué debo revisar antes de permitir que una IA ejecute un comando?

No permitas que un asistente de IA inicie por su cuenta el comando de larga duración run. Revisa todos los comandos generados por IA antes de ejecutarlos en una cuenta real.

Autenticación y credenciales ¶

¿Qué modalidades de autenticación existen?

cTrader CLI utiliza dos modalidades de autenticación. Los comandos por lotes requieren --ctid y --pwd-file. Los comandos interactivos requieren --ctid, --password o --pwd-file, y -q. Los comandos por lotes no admiten --password, mientras que los interactivos admiten ambas opciones de contraseña.

¿Cómo puedo guardar mi contraseña de forma segura?

Guarda tu contraseña de cTID en un archivo de texto sin formato. Mantén el archivo fuera de carpetas compartidas o sometidas a control de versiones, limita los permisos de lectura y elimínalo cuando ya no lo necesites.

¿Qué bróker debo elegir si varias cuentas tienen el mismo número?

Añade --broker=<broker-name> a cualquier comando. Esta opción selecciona el bróker cuando tu cTrader ID tiene cuentas con el mismo número en distintos brókeres.

Flujos de trabajo ¶

¿Qué operaciones admite cTrader CLI?

Las operaciones de cTrader CLI abarcan cuentas, trading, datos de mercado, historial, indicadores, alertas, cBots y proyectos.

¿Qué zona horaria utiliza cTrader CLI?

UTC para todas las fechas y horas de entrada y salida. Por ejemplo, --from=2026-10-08 comienza a las 00:00 UTC del 8 de octubre y los resultados muestran horas como 2026-10-08T14:05:00.000Z. La única excepción es la hora dentro de un cBot en ejecución, que sigue su configuración TimeZone.

¿Puedo establecer más de un nivel de take profit en una operación?

No. Actualmente, cTrader CLI solo admite un nivel de take profit por operación.

¿Puedo establecer un trailing stop loss o una protección de punto de equilibrio?

No. Actualmente, ninguna de estas dos funciones está disponible en cTrader CLI.

¿Puedo establecer una fecha de vencimiento para una orden pendiente?

No. Actualmente, cTrader CLI no permite establecer el vencimiento de las órdenes (good till date).

¿Puedo establecer un rango de mercado?

No. Actualmente, el rango de mercado no está disponible en cTrader CLI. La opción --limit-range se aplica a las órdenes de stop limitada.

¿Puedo elegir el método de activación del stop?

No. Actualmente, cTrader CLI no permite seleccionar el método de activación del stop.

¿Cómo puedo consultar todos los identificadores de periodo que admite la CLI?

Ejecuta ctrader-cli periods. El comando muestra todos los identificadores admitidos por --period y --timeframe. No se distingue entre mayúsculas y minúsculas.

¿Cómo ejecuto un cBot en un VPS o servidor en la nube?

Ejecuta el cBot dentro de la imagen Docker de cTrader CLI, montando la carpeta del equipo anfitrión y pasando los valores de configuración mediante variables de entorno.

Ciclo de vida de los cBots ¶

¿Qué versión de .NET necesita mi cBot?

El archivo .algo debe compilarse para .NET 8. Vuelve a compilar los cBots antiguos en la versión más reciente de la aplicación de escritorio de cTrader.

¿Cómo inicio un cBot desde el terminal?

Ejecuta ctrader-cli run <path-to-algo-file> --account=<account-id> --symbol=<symbol> --period=<period>. Este comando permanece en ejecución, así que utiliza --exit-on-stop si quieres que el proceso de cTrader CLI finalice cuando se detenga el cBot.

¿Cómo detengo todos los cBots en ejecución a la vez?

Abre la consola interactiva con ctrader-cli, inicia sesión y ejecuta stop all yes. El proceso de cTrader CLI finaliza cuando se detiene la última instancia.

¿Cómo paso parámetros a un cBot?

Puedes pasar los parámetros del cBot de tres maneras: utilizar los valores predeterminados, sustituir uno o dos valores mediante --ParameterName=value en la línea de comandos o pasar un archivo .cbotset guardado como segundo argumento posicional. Los archivos .cbotset proceden de la aplicación de escritorio de cTrader y permiten reutilizar los valores en distintas ejecuciones.

¿Cómo optimizo los parámetros de un cBot?

Para optimizar un cBot, ejecuta ctrader-cli optimize <path-to-algo-file> --params=<path-to-params-file>. El archivo de parámetros JSON especifica qué parámetros deben variar y cuáles deben permanecer fijos. Utiliza --criteria para las clasificaciones estándar o --fitness para el método GetFitness propio del cBot.