시작 방법 안내¶
코딩 경험에 따라 세 가지 경로로 QUANTIQ 자동매매를 시작할 수 있습니다.
경로 1: 커뮤니티 전략 가져오기¶
코딩 없이 시작하는 가장 빠른 방법입니다.
/community페이지에서 다른 사용자가 공유한 전략을 탐색합니다.- 마음에 드는 전략의 "가져오기" 버튼을 클릭하면 내 계정에 비공개 사본이 생성됩니다.
- 가져온 전략을 백테스트로 과거 성과를 확인합니다.
- 모의투자로 실시간 검증 후 실전에 적용합니다.
코드를 읽거나 수정할 필요가 없으며, 가져온 전략은 원본과 독립적으로 운영됩니다. 원본 전략이 수정되어도 내 사본에는 영향이 없습니다.
경로 2: AI 코드 초안 도우미¶
매매 아이디어가 있지만 코드 작성이 어려운 경우에 적합합니다.
- 스튜디오 에디터의 AI 채팅(LLM Studio)에서 매매 아이디어를 자연어로 설명합니다.
- AI가 QuantiqDSL 코드 초안을 생성합니다.
- 생성된 코드를 에디터에 붙여넣고 필요시 수정합니다.
- 백테스트와 모의투자로 검증합니다.
AI는 코드 초안을 제공하며, 최종 전략의 검증과 실행 판단은 사용자의 책임입니다.
AI 코드 초안 도우미의 범위와 한계
- 현재 AI 도우미는 에디터 내 LLM Studio(채팅)를 통해 DSL 코드 초안 생성을 지원합니다.
- AI가 생성한 코드는 초안이므로 반드시 백테스트와 모의투자로 검증해야 합니다.
- 전략 스크립트 내에서 AI에 직접 질의하는 기능(AI 어드바이저)은 준비 중입니다.
경로 3: 직접 코드 작성¶
개발 경험이 있거나 전략을 세밀하게 제어하고 싶은 경우에 적합합니다.
- 스튜디오 에디터에서 QuantiqDSL로 전략을 작성합니다.
- 자동완성, 구문 강조, 인라인 오류 표시 등의 에디터 기능을 활용합니다.
- 24종 이상의 내장 기술 지표(
ta.*)를 사용해 조건을 설계합니다. - 트레일링 스탑, 분할 매도 등 자유로운 청산 로직을 구현합니다.
자세한 문법은 첫 번째 전략 작성과 QuantiqDSL 언어 개요를 참고하세요.
공통 흐름: 시작까지 4단계¶
어떤 경로를 선택하든 아래 순서로 시작합니다.
| 단계 | 내용 | 예상 시간 |
|---|---|---|
| 1 | 회원가입 | 약 2분 |
| 2 | 프로그램 설치 | 약 5분 |
| 3 | 증권사 계좌 연결 (한국투자증권 KIS Open API) | 약 10분 |
| 4 | 모의투자 시작 | 약 5분 |
시스템 요구사항
- 운영체제: Windows / Mac 지원
- 증권사: 한국투자증권 KIS Open API (모의투자/실전투자 모두 지원)
- 브로커 연동: KIS Developers에서 API 키를 발급받아야 합니다.
백테스트와 검증¶
전략을 실전에 적용하기 전에 백테스트와 모의투자로 단계적으로 검증할 수 있습니다.
- 백테스트: 과거 데이터로 전략의 과거 성과를 시뮬레이션합니다. 스튜디오에서 백테스트를 실행하면 승률, 수익률, MDD(최대 낙폭) 등의 통계가 포함된 상세 보고서를 확인할 수 있습니다.
- 모의투자: 실시간 시장 데이터로 전략을 실행하되, 실제 돈은 사용하지 않습니다.
- 실전 전환: 모의투자로 충분히 검증한 뒤, 실전 모드로 전환합니다.
백테스트 유의사항
과거 백테스트 결과는 미래 수익을 보장하지 않습니다. 백테스트는 전략의 논리적 타당성을 확인하는 도구이며, 실제 시장 상황은 백테스트와 다를 수 있습니다.
멀티 전략 운영¶
여러 전략을 동시에 운영하며 상황에 따라 개별적으로 관리할 수 있습니다.
전략별 독립 운영¶
- 전략마다 독립적인 손절/익절 한도를 설정할 수 있습니다.
- 거래 탭(
/operations)에서 각 전략의 상태를 확인하고 관리합니다. - 전략별로 개별 ON/OFF 전환이 가능합니다.
전략 ON/OFF 제어¶
- 거래 탭: 운영 화면에서 전략별 활성/비활성 전환
- 텔레그램: 한국어 키워드 명령으로 원격 전략 ON/OFF (예: "전략명 비활성화")
- 엔진 중단: 모든 자동 주문을 한 번에 멈추는 즉시 중단 버튼 제공
자세한 운영 화면 사용법은 거래 탭 사용법을 참고하세요.
안전장치와 운영¶
3단계 리스크 관리¶
QUANTIQ는 3단계 리스크 관리를 제공합니다.
- 종목별 제한: 개별 종목의 손절/익절 한도 설정
- 전략별 제한: 전략 단위 일일 손실 한도 설정
- 계좌 제한: 계좌 전체 일일 손절 한도 설정
계좌 일일 손절 한도에 도달하면 해당 계좌의 모든 전략이 자동으로 중단됩니다.
장애 시나리오 대응¶
| 상황 | 시스템 대응 |
|---|---|
| PC 강제 종료 | 재시작 시 보유 포지션·미체결 주문 자동 복원 |
| 네트워크 끊김 | 재연결 후 미체결 주문 자동 동기화 |
| 장중 급락 | 계좌 일일 손절 한도 도달 시 전 전략 자동 중단 |
| 증권사 API 오류 | 주문 재시도 + 텔레그램 알림 |
원격 운영 (텔레그램 연동)¶
텔레그램을 연동하면 외출 중에도 다음이 가능합니다.
- 체결 알림 수신: 주문 체결, 손절/익절 발동 시 실시간 알림
- 전략 ON/OFF: 한국어 키워드 명령으로 개별 전략 활성/비활성 전환
- 엔진 중단: "엔진 중단" 명령으로 모든 자동 주문 즉시 정지
장중(09:00~15:20)에는 PC가 켜져 있어야 전략이 실행됩니다. 텔레그램 원격 제어는 PC가 실행 중일 때 동작합니다.
실행 환경¶
- 실제 자동매매 주문 전송은 사용자의 PC에서 동작하는 로컬 runtime이 담당합니다.
- 브로커 자격정보(API 키, 비밀번호)는 로컬 runtime에서 처리하며, 클라우드에 저장되지 않습니다.
- cloud는 사용자 계정, 스크립트/커뮤니티 메타데이터, 라이선스 등을 관리합니다.
- 자세한 실행 모델은 실행 모델을 참고하세요.
투명성 안내¶
- QUANTIQ는 수익을 보장하지 않습니다.
- 갭하락 등 극단적 시장 상황에서 100% 방어를 보장하지 않습니다. 장 시작 시 가격이 급변하면 손절가보다 불리한 가격에 체결될 수 있습니다.
- PC나 인터넷 연결이 끊기면 새 주문이 실행되지 않습니다.
- 모의투자로 충분히 검증한 뒤, 소액부터 단계적으로 실전에 적용하는 것을 권장합니다.
- 모든 투자 결과에 대한 책임은 사용자에게 있습니다.
오픈 베타¶
현재 QUANTIQ는 오픈 베타로 운영 중이며, 모의투자를 무료로 사용할 수 있습니다. 베타 기간 중 기능과 정책은 변경될 수 있습니다.
다음 단계¶
- 첫 번째 전략 작성 — DSL 코드를 직접 작성해보기
- 스튜디오 사용법 — 에디터와 도구 둘러보기
- 거래 탭 사용법 — 운영 화면과 전략 관리
- 초심자 트랙 — 단계별 학습 경로