Настройка cTrader CLI¶

В этой статье объясняется, как установить cTrader CLI, создать файл учетных данных и проверить подключение в Windows, macOS или Linux — через терминал или контейнер Docker.

Предварительные требования ¶

• cTrader ID как минимум с одним торговым счетом.
• Поддерживаемый менеджер пакетов: WinGet для Windows или Homebrew для macOS и Linux.
• Для сиБотов — .NET 8. Перед запуском старых сиБотов через cTrader CLI перекомпилируйте их в последней версии настольного приложения cTrader.
• Для использования навыков требуется Node.js версии 22.20.0 или новее.

Установка через менеджер пакетов ¶

Рекомендуется устанавливать cTrader CLI через менеджер пакетов. Он загружает версию для вашей операционной системы и добавляет команду ctrader-cli в переменную PATH, чтобы ее можно было выполнять из любой папки.

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

Установка с помощью Docker-образа ¶

cTrader CLI распространяется в виде Docker-образа для Linux, который удобно использовать для размещения сиБотов на VPS с Linux, высокопроизводительном сервере или облачной платформе. Этот образ также работает в Windows через Docker Desktop с WSL.

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

В руководстве по запуску сиБота показано, как подключать папки хост-системы и передавать настройки через переменные окружения.

Ручная установка в Windows ¶

Если вы не хотите использовать менеджер пакетов в Windows, исполняемый файл ctrader-cli уже включен в настольное приложение cTrader. Обычно он находится по следующему пути:

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

Чтобы запускать cTrader CLI из любой папки, добавьте этот каталог в PATH:

1. Скопируйте путь к папке, содержащей ctrader-cli.
2. В меню «Пуск» Windows найдите Переменные среды, затем выберите Изменение системных переменных среды.
3. В окне Свойства системы нажмите Переменные среды.
4. В разделе Переменные среды пользователя дважды щелкните Path.
5. Нажмите Создать, вставьте скопированный путь и нажмите ОК в каждом открытом диалоговом окне, чтобы сохранить изменения.

Проверка установки ¶

После установки убедитесь, что cTrader CLI доступен. Ни одна из двух команд не требует входа в систему.

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

Если терминал сообщает, что команда не найдена, закройте его и откройте снова, чтобы обновленная переменная PATH вступила в силу, затем повторите попытку.

Создание файла учетных данных ¶

Большинство команд выполняют действия с торговым счетом, поэтому им необходимы три значения: cTrader ID, пароль и номер счета.

В целях безопасности не вводите пароль cTrader ID непосредственно в команду. Сохраните его в файле и укажите путь к этому файлу с помощью --pwd-file.

1. Откройте обычный текстовый редактор, например Блокнот.
2. Введите пароль cTrader ID в одну строку, без пробелов в начале и конце.
3. Сохраните файл с расширением .pwd или .txt, например password.pwd.
4. Укажите файл в команде: --pwd-file=C:/test/password.pwd.

Подготовив файл учетных данных, передавайте его командам одним из двух способов аутентификации.

Пример запуска в Docker ¶

В контейнере пути хост-системы подключаются через --mount, а значения настроек передаются через -e. Краткий пример запуска сиБота в контейнере:

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

Полное руководство по Docker с объяснением всех параметров см. в разделе Запуск и управление сиБотами.