콘텐츠로 이동

cTrader CLI

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

1분 만에 알아보는 cTrader CLI!

cTrader CLI를 사용하는 방법은 크게 두 가지입니다. 명령어를 직접 입력하거나 스크립트로 실행할 수 있습니다. 또는 AI 에이전트가 사용자의 자연어 요청을 cTrader CLI 명령어로 변환하도록 한 뒤, 해당 명령어를 검토하고 실행할 수도 있습니다. 어느 방법을 선택하든 다음 작업을 할 수 있습니다.

  • 검토하고 실행할 CLI 명령어를 작성해 주는 AI 에이전트에 cTrader 연결하기
  • AI 에이전트가 cTrader CLI를 올바르게 사용하도록 알려 주는 스킬 설치하기
  • cTrader 데스크톱 애플리케이션을 계속 열어 두지 않고 Windows, macOS, Linux에서 cBot을 실행하여 RAM과 CPU 자원 절약하기
  • 자원 소모가 큰 데스크톱 컴퓨터 대신 저렴한 Linux VPS나 클라우드 서버에서 cBot 호스팅하기
  • 스크립트와 자동화된 워크플로를 통해 계정 데이터, 가격, 거래 내역을 조회하고 주문을 제출하며 주문과 포지션을 관리하기

참고

cTrader CLI는 사용자의 컴퓨터 또는 서버에서 cBot을 실행합니다. 이는 cTrader가 자체 서버에서 cBot을 호스팅하는 클라우드에서 cBot 실행과 다릅니다. 클라우드 실행 방식에서는 사용자 측에서 별도의 프로세스를 계속 실행할 필요가 없습니다.

cTrader CLI 활용 시나리오

cTrader CLI는 크게 두 가지 활용 시나리오를 지원합니다. 두 시나리오 모두 그래픽 인터페이스 대신 텍스트 명령어를 사용하지만, 적합한 목적은 서로 다릅니다.

비교 항목 AI 에이전트(별도 인터페이스 없음) VPS 또는 클라우드에서 자체 호스팅
목적 터미널이나 그래픽 사용자 인터페이스 없이 AI 어시스턴트를 통해 cTrader를 조작합니다. 데스크톱 애플리케이션을 닫아 둔 상태에서 직접 관리하는 서버에서 cBot을 24시간 실행합니다.
일반적인 사용자 자연어로 목표를 설명하는 사용자입니다. AI 어시스턴트가 명령어 초안을 작성하면 사용자가 검토한 후 실행합니다. 터미널 사용에 익숙하며 명령어를 직접 입력하거나 스크립트로 실행하는 트레이더 또는 운영 담당자입니다.
명령어 생성 방식 자연어 요청이나 스크립트로 구성한 에이전트 워크플로를 바탕으로 AI가 생성합니다. 터미널에 직접 입력하거나 스크립트, cron 작업 또는 docker run을 통해 실행합니다.
출력 처리 AI가 JSON을 파싱하여 응답이나 다음 프롬프트를 생성합니다. JSON을 stdout으로 출력하거나 파일로 리디렉션하거나 파이프를 통해 다른 도구에 전달합니다.
장시간 실행되는 명령어 AI 에이전트가 run을 자율적으로 시작해서는 안 됩니다. AI 에이전트는 cbots를 안전하게 모니터링하고 price의 실시간 가격 출력을 읽을 수 있습니다. 다만 cBot을 시작하거나 설정하거나 중지하는 명령어는 실행 전에 반드시 검토해야 합니다. run은 장시간 실행되는 프로세스를 시작하므로 systemd, Docker와 같은 프로세스 감독 도구 또는 --exit-on-stop 옵션이 필요합니다. 그 밖의 CLI 명령어는 모두 한 번 실행되어 결과를 반환한 후 종료됩니다.

참고

두 시나리오 모두 서버 또는 워크스테이션을 직접 준비하고 관리해야 합니다. cTrader CLI에는 관리형 호스팅 서비스가 포함되어 있지 않습니다.

cTrader CLI 설정

cTrader CLI와 cTrader MCP 서버 비교

cTrader CLI와 cTrader MCP 서버 모두 인터페이스를 직접 클릭하지 않고도 cTrader를 조작할 수 있지만, 작동 방식은 서로 다릅니다. 아래 표에서 작업 방식에 적합한 옵션을 확인하세요.

cTrader CLI cTrader MCP 서버
상호작용 방식 터미널에 명령어를 직접 입력하거나, AI가 작성한 명령어를 검토한 후 실행합니다. 원하는 작업을 자연어로 설명하면 AI 에이전트가 대신 수행합니다.
cTrader 애플리케이션 필요 여부 필요하지 않습니다. 터미널, VPS 또는 컨테이너에서 독립적으로 실행됩니다. cTrader 실행 환경을 백그라운드에서 계속 열어 두어야 합니다. 로컬 사용 시에는 Windows 또는 macOS의 데스크톱 애플리케이션이, 원격 사용 시에는 cTrader Web 세션이 필요합니다.
작업 결과 표시 위치 터미널에 텍스트 및 JSON으로만 표시되며 cTrader 인터페이스에는 아무것도 표시되지 않습니다. 기존 플랫폼 화면과 함께 cTrader 인터페이스에 표시됩니다.
가장 적합한 용도 스크립트로 반복 가능한 작업을 자동화하고 서버에서 cBot을 호스팅하는 경우 AI 어시스턴트와 대화하며 거래하거나 분석을 수행하고 일회성 질문을 하는 경우

팁

반복 실행과 정밀한 제어가 가장 중요하다면 cTrader CLI를 선택하세요. AI 에이전트와 대화하며 상호작용하는 것이 우선이라면 cTrader MCP 서버를 선택하세요.

cTrader CLI 살펴보기

작업

cTrader CLI는 작업 유형에 따라 명령어를 분류합니다. 아래 표에서 지원되는 작업을 확인할 수 있습니다. 각 명령어의 자세한 구문, 옵션 및 예시는 CLI 참조 문서에서 확인하세요.

작업 cTrader CLI
계정 목록을 조회하고 계정 통계 확인 ✅
사용 가능한 심벌을 나열하고 해당 심벌의 트레이딩 세션과 거래 조건 확인 ✅
실시간 가격과 과거 캔들 데이터 조회 ✅
고정 손절매 및 이익실현 수준을 지정한 시장가 주문, Limit 주문, Stop 주문, 역지정 지정가(Stop-Limit) 주문을 제출하고, 예약 주문을 수정·취소하며 기존 주문 목록 조회 ✅
고정된 손절매 및 이익실현 수준 변경, 포지션 전부 또는 일부 청산, 미청산 포지션 목록 조회 ✅
거래 내역, 완료된 주문의 기록 및 현재 익스포저 데이터 조회 ✅
지표의 현재 값과 과거 값을 계산하고 사용 가능한 지표 목록 조회 ✅
가격 알림을 생성·삭제하고 목록 조회 ✅
cBot을 실행하거나 중지하고 백테스트를 수행하며 cBot 메타데이터 조회 ✅
cBot 최적화 ✅
cBot, 지표 및 플러그인 프로젝트의 기본 구조를 생성하고 프로젝트 빌드 ✅

경고

cTrader CLI는 거래와 자동화를 위한 도구입니다. 금융, 투자, 법률 또는 세무 관련 자문은 제공하지 않습니다. 주문을 제출하거나 변경하는 명령어는 실제 거래를 발생시켜 손실로 이어질 수 있습니다. 각 명령어를 실행하기 전에 확인하고, 먼저 데모 계정에서 테스트하며, 로그인 정보를 안전하게 보호하세요.