cBot 작업¶

이 문서에서는 cTrader CLI에서 cBot의 실행 수명 주기를 설명합니다. 터미널에서 cBot을 실행하고, 실행 중인 인스턴스를 조회하거나 중지하고, Docker를 사용해 VPS 또는 클라우드 서버에서 cBot을 호스팅하고, 과거 데이터로 백테스트하는 방법을 알아보세요.

사전 요구 사항 ¶

• cTrader CLI가 설치되어 있어야 합니다.
• cTrader ID, 인증 정보 파일 및 계정 번호를 준비해야 합니다.
• cBot이 .NET 8용으로 빌드된 .algo 파일로 내보내져 있어야 합니다.

cBot 메타데이터 확인 ¶

cBot을 실행하기 전에 metadata로 cBot이 지원하는 매개변수를 나열하세요. 출력에는 각 cBot 속성의 이름과 유형이 표시됩니다.

ctrader-cli metadata <path-to-algo-file>

명령줄이나 .cbotset 파일로 매개변수를 지정할 때는 메타데이터 출력에 표시된 매개변수 이름을 사용하세요.

cBot 실행 ¶

run으로 cBot을 시작하세요. .algo 파일 경로를 첫 번째 인수로 지정합니다. --account, --symbol, --period는 필수입니다.

ctrader-cli run <path-to-algo-file> --account=<account-id> --symbol=<symbol> --period=<period>

매개변수를 전달하는 세 가지 방법이 있습니다.

자동 실행 시 유용한 선택적 옵션 두 가지가 있습니다.

VPS 또는 클라우드 서버에서 cBot 실행 ¶

터미널만 사용하는 도구는 소규모 Linux 인스턴스에서도 원활하게 실행됩니다. 따라서 데스크톱 컴퓨터보다 적은 비용으로 cBot을 계속 실행할 수 있습니다. 이를 위한 가장 이식성 높은 방법은 cTrader CLI Docker 이미지를 사용하는 것입니다.

최신 이미지를 가져오세요:

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

컨테이너에서 cBot을 실행하세요. --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

cTrader 데스크톱 애플리케이션에서 시작 ¶

cTrader CLI를 사용하기 위해 명령줄 사용법을 익힐 필요는 없습니다.

1. cTrader 데스크톱 애플리케이션에서 원하는 매개변수로 cBot을 준비하세요.
2. 로컬 cBot 인스턴스를 마우스 오른쪽 버튼으로 클릭하고 외부 프로세스에서 시작을 선택하세요. cTrader CLI가 자동으로 시작되어 해당 인스턴스를 독립적으로 실행합니다.
3. CPU와 RAM 사용량을 줄이려면 데스크톱 애플리케이션을 종료하세요. cBot은 cTrader CLI 프로세스에서 계속 실행됩니다.

cBot 목록 조회 및 중지 ¶

계정에서 현재 실행 중인 cBot 인스턴스를 나열하세요:

ctrader-cli cbots --ctid=letstrade --password=secret --account=1234567 -q

run의 출력에 표시되는 식별자를 사용해 실행 중인 인스턴스를 중지하세요:

ctrader-cli stop --ctid=letstrade --password=secret --account=1234567 -q --instance=<instance-id>

실행 중인 모든 cBot을 한 번에 중지하려면 대화형 셸을 열고 stop all yes를 실행하세요. 마지막 인스턴스가 중지되면 cTrader CLI 프로세스도 종료됩니다.

cBot 백테스트 ¶

backtest로 cBot을 과거 데이터에 대해 테스트하세요. .algo 파일 경로가 첫 번째 인수이며, 선택적으로 .cbotset 파일을 이어서 지정할 수 있습니다. 테스트에는 심벌, 시간 프레임, 날짜 범위도 필요합니다:

ctrader-cli backtest <path-to-algo-file> [<path-to-cbotset-file>] --account=<account-id> --symbol=<symbol> --period=<period> --start=<start-date> --end=<end-date> --data-mode=<data-mode>

테스트 환경 옵션 ¶

테스트 환경 옵션은 CLI 참조 문서의 backtest 항목 아래에 나와 있습니다. 필수 입력값은 --start, --end, --data-mode뿐입니다. 선택적 옵션을 사용하면 시작 잔액, 수수료, 스프레드, 데이터 소스 및 보고서 출력을 지정할 수 있습니다.

데이터 모드 ¶

실습 예시 ¶

하나의 .cbotset 매개변수 파일을 사용해 예제 cBot의 백테스트를 실행하세요:

ctrader-cli backtest "C:/test/sample martingale.algo" C:/test/special-parameters.cbotset \
  --ctid=letstrade --pwd-file=C:/test/password.pwd --account=1234567 --symbol=EURUSD --period=h1 \
  --start="01/01/2025 12:34" --end="31/01/2025 20:56" \
  --balance=10000 --commission=30 --commission-type=UsdPerMillionUsdVolume --spread=1 --data-mode=m1

백테스트 출력 ¶

cTrader CLI는 진행 상황을 터미널에 실시간으로 출력하고 완료되면 요약을 표시합니다. 전체 결과는 .algo 파일 옆의 Backtesting 폴더에 저장되며 실행할 때마다 별도의 하위 폴더가 생성됩니다:

…/data/{cBotName}/{BacktestingInstanceID}/Backtesting

--report와 --report-json을 사용하면 위 폴더뿐 아니라 지정된 경로에도 보고서를 저장할 수 있습니다.

cTrader CLI에서 Algo API의 동작 ¶

cTrader CLI에는 그래픽 인터페이스가 없으므로 cBot을 실행할 때 일부 cTrader Algo API 멤버의 동작이 달라집니다.