Часто задаваемые вопросы¶

Основные сведения ¶

Что такое cTrader CLI?

cTrader CLI — инструмент командной строки для управления счетами, торговыми и алгоритмическими операциями непосредственно из терминала, без запуска настольного приложения cTrader. С помощью команд можно входить в систему, получать рыночные данные, открывать сделки и управлять ими, а также запускать сиБотов, тестировать их на исторических данных и оптимизировать.

Что нужно для работы с cTrader CLI?

Вам понадобятся cTrader ID хотя бы с одним торговым счетом, исполняемый файл cTrader CLI, доступный через PATH, и файл учетных данных cTrader ID.

Как установить cTrader CLI?

Используйте менеджер пакетов в Windows, macOS или Linux. Он загрузит версию, подходящую для вашей операционной системы. Также доступен Docker-образ, а в Windows исполняемый файл входит в состав настольного приложения cTrader.

cTrader CLI бесплатный?

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

ИИ-агенты ¶

Можно ли использовать ИИ-ассистента с cTrader CLI?

Да. С cTrader CLI можно работать двумя способами: самостоятельно вводить команды и писать скрипты либо описывать цели на естественном языке и поручать ИИ-ассистенту подготовку команд cTrader CLI, которые вы затем проверите и выполните.

Нужно ли устанавливать навык для работы с ИИ-ассистентом?

Нет. ИИ-ассистент может предлагать команды cTrader CLI и без установленного навыка. Установка навыков предоставляет агенту справочные материалы по синтаксису команд, их выводу и правилам безопасности, помогая создавать более надежные команды.

Что нужно проверить, прежде чем разрешить ИИ выполнять команду?

Не позволяйте ИИ-ассистенту самостоятельно запускать длительно выполняющуюся команду run. Проверяйте каждую созданную ИИ команду перед ее выполнением на реальном счете.

Аутентификация и учетные данные ¶

Какие существуют способы аутентификации?

cTrader CLI использует два способа аутентификации. Для пакетных команд нужны --ctid и --pwd-file; для интерактивных — --ctid, --password или --pwd-file, а также -q. Пакетные команды не принимают --password, а интерактивные поддерживают оба варианта передачи пароля.

Как безопасно хранить пароль?

Сохраните пароль cTID в обычном текстовом файле. Храните файл вне общих папок и каталогов под контролем версий, ограничьте права на чтение и удалите его, когда он больше не нужен.

Как выбрать брокера, если у нескольких счетов одинаковый номер?

Добавьте --broker=<broker-name> к любой команде. Этот параметр выбирает брокера, если с вашим cTrader ID связаны счета с одинаковыми номерами у разных брокеров.

Рабочие процессы ¶

Какие операции поддерживает cTrader CLI?

Операции cTrader CLI охватывают счета, торговлю, рыночные данные, историю, индикаторы, оповещения, сиБотов и проекты.

Какой часовой пояс использует cTrader CLI?

UTC — для всех дат и значений времени во входных данных и выводе. Например, --from=2026-10-08 означает 8 октября, 00:00 UTC, а в выводе время может отображаться в формате 2026-10-08T14:05:00.000Z. Единственное исключение — время внутри запущенного сиБота: оно определяется настройкой TimeZone этого сиБота.

Можно ли задать несколько уровней тейк-профита для сделки?

Нет. Сейчас cTrader CLI поддерживает только один уровень тейк-профита на сделку.

Можно ли установить трейлинг-стоп или защиту безубыточности?

Нет. Сейчас обе функции недоступны в cTrader CLI.

Можно ли задать срок действия отложенного ордера?

Нет. Сейчас в cTrader CLI нельзя задать дату истечения срока ордера (good till date).

Можно ли задать максимальное проскальзывание?

Нет. Сейчас в cTrader CLI нельзя задать максимальное проскальзывание. Параметр --limit-range применяется к стоп-лимитным ордерам.

Можно ли выбрать метод срабатывания стоп-ордера?

Нет. Сейчас cTrader CLI не позволяет выбирать метод срабатывания стоп-ордера.

Как вывести все допустимые обозначения периодов в CLI?

Выполните ctrader-cli periods. Команда выводит все обозначения, поддерживаемые параметрами --period и --timeframe. Регистр символов не учитывается.

Как запустить сиБота на VPS или облачном сервере?

Запустите сиБота в Docker-образе cTrader CLI, подключив папку хост-системы и передав настройки через переменные окружения.

Жизненный цикл сиБотов ¶

Какая версия .NET требуется для сиБота?

Файл .algo должен быть скомпилирован для .NET 8. Перекомпилируйте старых сиБотов в последней версии настольного приложения cTrader.

Как запустить сиБота из терминала?

Выполните ctrader-cli run <path-to-algo-file> --account=<account-id> --symbol=<symbol> --period=<period>. Эта команда выполняется длительное время. Используйте --exit-on-stop, если хотите, чтобы процесс cTrader CLI завершался после остановки сиБота.

Как остановить всех запущенных сиБотов одновременно?

Откройте интерактивную оболочку командой ctrader-cli, войдите в систему и выполните stop all yes. Процесс cTrader CLI завершается после остановки последнего экземпляра.

Как передать параметры сиБоту?

Передать параметры сиБота можно тремя способами: оставить значения по умолчанию, переопределить одно или два значения через --ParameterName=value в командной строке либо передать сохраненный файл .cbotset вторым позиционным аргументом. Файлы .cbotset создаются в настольном приложении cTrader и позволяют повторно использовать значения при разных запусках.

Как оптимизировать параметры сиБота?

Чтобы оптимизировать сиБота, выполните ctrader-cli optimize <path-to-algo-file> --params=<path-to-params-file>. В файле параметров JSON указывается, какие параметры следует перебирать, а какие оставить неизменными. Используйте --criteria для стандартных критериев ранжирования или --fitness для собственного метода сиБота GetFitness.