자주 묻는 질문¶

기본 사항 ¶

cTrader CLI란 무엇인가요?

cTrader CLI는 cTrader 데스크톱 애플리케이션을 열지 않고 터미널에서 계정, 거래 및 알고리즘 작업을 직접 관리할 수 있는 명령줄 도구입니다. 명령어를 입력하여 로그인하고 시장 데이터를 조회하고 거래를 시작하거나 관리할 수 있으며 cBot 실행, 백테스트 및 최적화도 수행할 수 있습니다.

cTrader CLI를 실행하려면 무엇이 필요한가요?

하나 이상의 거래 계정이 연결된 cTrader ID, PATH에서 접근할 수 있는 cTrader CLI 실행 파일, cTrader ID 인증 정보 파일이 필요합니다.

cTrader CLI는 어떻게 설치하나요?

Windows, macOS 또는 Linux에서 패키지 관리자를 사용하세요. 패키지 관리자가 운영체제에 적합한 빌드를 다운로드합니다. Docker 이미지도 제공되며, Windows에서는 cTrader 데스크톱 애플리케이션에 실행 파일이 포함되어 있습니다.

cTrader CLI는 무료인가요?

예. cTrader CLI는 cTrader에 포함되어 있습니다. 사용자 자신의 cTrader ID와 인증 정보 파일이 필요하며, 감독 없이 cBot을 실행하려면 호스팅 환경도 준비해야 합니다.

AI 에이전트 ¶

cTrader CLI에 AI 어시스턴트를 사용할 수 있나요?

예. cTrader CLI에서는 명령어를 직접 입력하고 스크립트를 작성하거나, 자연어로 목표를 설명하고 AI 어시스턴트가 제안한 cTrader CLI 명령어를 검토한 후 실행하는 두 가지 방식으로 작업할 수 있습니다.

AI 어시스턴트를 사용하려면 스킬을 설치해야 하나요?

아니요. 스킬을 설치하지 않아도 AI 어시스턴트가 cTrader CLI 명령어를 제안할 수 있습니다. 스킬을 설치하면 AI 에이전트에 명령어 구문, 출력 및 안전 규칙에 관한 참조 자료가 제공되어 생성되는 명령어의 신뢰성이 높아집니다.

AI가 명령어를 실행하도록 허용하기 전에 무엇을 확인해야 하나요?

AI 어시스턴트가 장시간 실행되는 run 명령어를 스스로 시작하도록 허용하지 마세요. AI가 생성한 모든 명령어는 라이브 계정에서 실행하기 전에 검토하세요.

인증 및 인증 정보 ¶

어떤 인증 방식이 있나요?

cTrader CLI는 두 가지 인증 방식을 사용합니다. 일괄 처리 명령어에는 --ctid와 --pwd-file이 필요하며, 대화형 명령어에는 --ctid, --password 또는 --pwd-file, 그리고 -q가 필요합니다. 일괄 처리 명령어는 --password를 허용하지 않지만, 대화형 명령어는 두 비밀번호 옵션을 모두 허용합니다.

비밀번호를 안전하게 저장하려면 어떻게 하나요?

cTID 비밀번호를 일반 텍스트 파일에 저장하세요. 공유 폴더나 버전 관리 대상 폴더 외부에 파일을 보관하고 읽기 권한을 제한하며, 더 이상 필요하지 않으면 삭제하세요.

여러 브로커의 계정 번호가 같으면 어느 브로커를 선택해야 하나요?

명령어에 --broker=<broker-name>을 추가하세요. cTrader ID에 연결된 계정 번호가 여러 브로커에서 중복될 때 해당 옵션으로 브로커를 선택할 수 있습니다.

워크플로 ¶

cTrader CLI는 어떤 작업을 지원하나요?

cTrader CLI 작업에는 계정, 거래, 시장 데이터, 거래 내역, 지표, 알림, cBot 및 프로젝트가 포함됩니다.

cTrader CLI는 어떤 시간대를 사용하나요?

입력과 출력의 모든 날짜 및 시간에 UTC를 사용합니다. 예를 들어 --from=2026-10-08은 10월 8일 00:00 UTC부터 시작하며, 출력에는 2026-10-08T14:05:00.000Z와 같은 시간이 표시됩니다. 유일한 예외는 실행 중인 cBot 내부의 시간으로, 해당 cBot의 TimeZone 설정을 따릅니다.

한 거래에 여러 이익 실현 수준을 설정할 수 있나요?

아니요. 현재 cTrader CLI는 거래당 하나의 이익 실현 수준만 지원합니다.

트레일링 스톱로스 또는 손익분기점 보호를 설정할 수 있나요?

아니요. 두 기능 모두 현재 cTrader CLI에서 지원되지 않습니다.

대기 주문에 만료일을 설정할 수 있나요?

아니요. 현재 cTrader CLI에서는 주문 만료일(good till date)을 설정할 수 없습니다.

시장 범위를 설정할 수 있나요?

아니요. 현재 cTrader CLI에서는 시장 범위(market range)를 설정할 수 없습니다. --limit-range 옵션은 역지정 지정가(Stop-Limit) 주문에 적용됩니다.

스톱 주문의 트리거 방식을 선택할 수 있나요?

아니요. 현재 cTrader CLI는 스톱 주문의 트리거 방식 선택을 지원하지 않습니다.

CLI에서 허용하는 모든 기간 토큰을 어떻게 확인하나요?

ctrader-cli periods를 실행하세요. 이 명령어는 --period 및 --timeframe에서 허용하는 모든 토큰을 출력합니다. 대소문자를 구분하지 않습니다.

VPS나 클라우드 서버에서 cBot을 어떻게 실행하나요?

호스트 폴더를 마운트하고 환경 변수로 설정값을 전달하여 cTrader CLI Docker 이미지 안에서 cBot을 실행하세요.

cBot 수명 주기 ¶

cBot에는 어떤 .NET 버전이 필요한가요?

.algo 파일은 .NET 8용으로 빌드해야 합니다. 이전 cBot은 최신 cTrader 데스크톱 애플리케이션에서 다시 컴파일하세요.

터미널에서 cBot을 어떻게 시작하나요?

ctrader-cli run <path-to-algo-file> --account=<account-id> --symbol=<symbol> --period=<period>를 실행하세요. 이 명령어는 장시간 실행됩니다. cBot이 멈출 때 cTrader CLI 프로세스도 종료하려면 --exit-on-stop을 사용하세요.

실행 중인 모든 cBot을 한 번에 어떻게 중지하나요?

ctrader-cli로 대화형 셸을 열고 로그인한 뒤 stop all yes를 실행하세요. 마지막 인스턴스가 중지되면 cTrader CLI 프로세스가 종료됩니다.

cBot에 매개변수를 어떻게 전달하나요?

cBot 매개변수는 세 가지 방식으로 전달할 수 있습니다. cBot의 기본값을 사용하거나, 명령줄에서 --ParameterName=value를 사용해 한두 값을 덮어쓰거나, 저장된 .cbotset 파일을 두 번째 위치 인수로 전달하세요. .cbotset 파일은 cTrader 데스크톱 애플리케이션에서 생성하며 실행할 때마다 같은 값을 다시 사용할 수 있습니다.

cBot 매개변수를 어떻게 최적화하나요?

cBot을 최적화하려면 ctrader-cli optimize <path-to-algo-file> --params=<path-to-params-file>를 실행하세요. JSON 매개변수 파일에서 변경할 매개변수와 고정할 매개변수를 지정합니다. 표준 순위 기준에는 --criteria를, cBot 자체의 GetFitness 메서드에는 --fitness를 사용하세요.