SQStock Quant처음 사용 안내 운영 화면으로 돌아가기

KOSPI 200 + KOSDAQ 150 QUANT PLATFORM

처음 사용하는 분을 위한 단계별 매뉴얼

이 사이트는 종목을 직접 추천받아 바로 매수하는 화면이 아닙니다. 데이터를 모으고, 전략을 검증하고, 가상운영을 통과한 전략만 제한된 모의투자로 보내는 안전 중심 자동매매 연구 플랫폼입니다.

기본 상태 LOCKED 실전 주문 별도 승인 전 차단 권장 시작 모의투자 연결
어디에서 무엇을 보나요?

① 오늘의 현황: 현재 상태와 다음 확인할 일 → ② 전략 찾기·검증: 종목별 설정·가상매매·모의투자 준비 → ③ 계좌와 거래: 잔액·보유·주문·손익 → ④ 관리: 연결 정보와 안전 설정.

가상매매는 실제 돈을 쓰지 않습니다. 모의투자는 증권사 모의계좌를 사용합니다. 실전투자는 실제 자금이 사용되므로 별도 승인이 필요합니다. 설정 화면은 상태 확인을 위해서도 열 수 있지만, 저장하면 실제 설정이 바뀔 수 있습니다.

01

START HERE

가장 먼저 알아야 할 5가지

돈이 움직일 수 있는 시스템입니다

처음에는 반드시 LOCKED와 Kill Switch ON을 유지하세요. 모의 연결 테스트가 성공하고 전략 검증 상태를 이해하기 전에는 CANARY로 바꾸지 마세요.

  1. LOCKED는 정상입니다.

    고장이나 미설정 표시가 아니라, 모든 주문을 막는 가장 안전한 대기 상태입니다.

  2. paper는 모의투자, live는 실전투자입니다.

    처음에는 모의 계정부터 연결합니다. 실전 연결 테스트도 현재는 읽기 전용으로만 수행됩니다.

  3. 후보 전략이 있어도 바로 거래하지 않습니다.

    자료와 실행 안전조건을 충족하면 연구용 가상매매로 폭넓게 관찰할 수 있습니다. 과거 성과가 부족한 후보도 포함되며, 가상 관찰 등록이 모의·실전 거래 승인이라는 뜻은 아닙니다.

  4. Shadow는 가상체결입니다.

    실제 시장 데이터를 사용하지만 증권사에 주문을 보내지 않습니다.

  5. Canary도 먼저 모의투자에서만 진행합니다.

    사이트 화면에서 실전매매 승인을 할 수 없으며, 별도 명시적 승인 전에는 실전 주문이 차단됩니다.

한눈에 보는 전체 흐름

① 데이터 수집종목·일봉·5분봉→ ② 후보 생성지표·파라미터 탐색→ ③ 검증OOS·Walk-Forward→ ④ Shadow실주문 없는 가상체결→ ⑤ Canary제한된 모의주문→ ⑥ 실전 승인자동 승인 금지
02

QUICK START

최초 설정은 이 순서대로

  1. 관리자 로그인

    사이트 첫 화면에서 관리자 아이디와 비밀번호를 입력합니다. 공용 PC에서는 로그인 상태를 남기지 말고 사용 후 반드시 로그아웃하세요.

    정상 기준왼쪽 메뉴와 상단의 시스템 상태가 보입니다.
  2. 오늘의 현황에서 LOCKED 확인

    상단 오른쪽과 첫 번째 카드에 LOCKED가 표시되는지 봅니다. 처음인데 SHADOW 또는 CANARY로 표시된다면 안전 설정에서 즉시 Kill Switch를 켭니다.

    정상 기준운영 모드 LOCKED · LIVE 미승인
  3. 증권사·알림 연결에서 모의 KIS 정보 입력

    모의투자 App Key, App Secret, 모의계좌번호, 모의 계좌상품코드와 HTS ID를 입력한 뒤 “입력한 값만 암호화 저장”을 누릅니다.

    중요기존 값을 다시 입력할 필요가 없습니다. 비어 있는 칸은 변경되지 않습니다.
  4. 모의 KIS 전체 테스트

    저장 후 “모의 KIS 전체 테스트”를 누릅니다. 인증, 삼성전자 시세, 계좌잔고를 읽기 전용으로 확인합니다.

    정상 기준“모의투자 인증 연결에 성공했습니다.”
  5. 실전 KIS는 읽기 테스트만

    실전 App Key와 계좌정보도 저장했다면 “실전 KIS 읽기 테스트”로 조회만 검증합니다. 이 버튼은 주문을 전송하지 않습니다.

  6. 분석 대상 종목와 연구 데이터 확인

    오늘의 현황의 분석 대상 종목가 약 350종목인지, 전략 찾기·검증의 대상 종목과 일봉 데이터가 0이 아닌지 확인합니다.

  7. 안전 설정는 아직 변경하지 않기

    최초 연결 직후에는 LOCKED와 Kill Switch ON을 그대로 유지합니다. 후보가 OOS를 통과하기 전에는 Shadow를 켜도 실제로 검증할 전략이 없습니다.

03

OVERVIEW

오늘의 현황 화면 읽는 법

운영 모드

LOCKED는 주문 차단, SHADOW는 가상운영, CANARY는 승인된 전략의 제한 모의주문 단계입니다.

분석 대상 종목

현재 활성화된 KOSPI200·KOSDAQ150 종목 수입니다. 구성종목 변경이나 공식 마스터 처리 시 약 350 전후로 표시될 수 있습니다.

전략

현재 연구·검증 중인 활성 후보 수입니다. 후보 수가 많다고 성능이 좋은 것은 아닙니다. 아래의 “OOS 통과”가 더 중요합니다.

오늘 주문

주문 현황 자리입니다. LOCKED 또는 Shadow 단계에서는 증권사 실주문이 발생하지 않는 것이 정상입니다.

공식 분석 대상 종목 갱신 버튼

한국투자증권 공식 종목 마스터에서 KOSPI200과 KOSDAQ150 구성종목을 다시 읽습니다. 평소에는 자동 갱신되므로 반복해서 누를 필요가 없습니다.

버튼을 누를 때

지수 정기변경이 있었거나 분석 대상 종목 숫자가 0으로 보일 때 한 번만 누르고 완료 메시지를 기다리세요.

종목 스캐너

최근 20일 가격 모멘텀과 거래량 비율을 이용해 관찰 우선순위를 보여줍니다. 이것은 매수 추천이나 주문 신호가 아닙니다.

  • 종목명(코드): 공식 종목명과 6자리 종목코드
  • 거래량 n배: 최근 거래량이 비교 기준보다 얼마나 큰지
  • 오른쪽 %: 최근 20일 모멘텀. 높다고 자동 매수하지 않음
04

CONNECTIONS

증권사·알림 연결 항목을 하나씩 이해하기

Write-only 보안 저장소

저장된 원문은 화면에 다시 나타나지 않습니다. “설정됨”만 표시됩니다. 새 값을 입력한 항목만 교체되며 비워 둔 항목은 기존 값이 유지됩니다.

접속 환경 (paper/live)

paper는 모의투자, live는 실전투자를 뜻합니다. 이 기본 선택과 별개로 화면의 모의/실전 테스트 버튼은 각각 해당 계정 정보를 직접 검사합니다. 처음에는 paper를 권장합니다.

모의투자 App Key / App Secret

한국투자증권 Open API 포털에서 모의투자용으로 발급된 키입니다. 실전용 키와 섞어 입력하지 마세요. 앞뒤 공백 없이 그대로 붙여넣습니다.

모의투자 계좌번호

한국투자증권 Open API의 모의투자 계좌번호를 입력합니다. 실전 계좌번호를 넣는 칸이 아닙니다. 하이픈이 표시된다면 API 안내에 따라 계좌번호 부분과 상품코드를 나눠 입력합니다.

모의 계좌상품코드

계좌번호 뒤에 붙는 2자리 상품코드입니다. 국내 주식 종합계좌는 흔히 01이지만, 화면이나 KIS 포털에 표시된 실제 값을 우선하세요.

실전투자 App Key / App Secret

실전투자용으로 발급된 별도 키입니다. 저장해도 실전 주문이 승인되는 것은 아닙니다. 현재 테스트 버튼은 인증·시세·잔고만 읽습니다.

실전투자 계좌번호 / 상품코드

실제 증권계좌의 계좌번호 부분과 2자리 상품코드를 각각 입력합니다. 모의 계좌와 반드시 분리하세요.

HTS ID

한국투자증권 HTS/MTS 로그인에 사용하는 사용자 ID입니다. 계좌번호나 고객번호가 아닙니다.

Telegram Bot Token / Chat ID

작업 실패와 운영 알림을 받을 Telegram 봇 정보입니다. Bot Token은 BotFather가 발급한 값, Chat ID는 알림을 받을 대화의 숫자 ID입니다.

안전한 입력 순서

  1. 필요한 항목만 입력합니다.
  2. “입력한 값만 암호화 저장”을 한 번 누릅니다.
  3. 각 항목 오른쪽이 “설정됨”으로 바뀌는지 확인합니다.
  4. 먼저 “모의 KIS 전체 테스트”를 누릅니다.
  5. 모의 테스트 성공 후에만 실전 읽기 테스트를 합니다.
  6. 입력 완료 후 브라우저 자동완성이나 메모장에 비밀 값을 남기지 않습니다.
Telegram이나 채팅으로 비밀 값을 보내지 마세요

App Key, App Secret, 계좌번호, Bot Token은 오직 사이트의 보안 입력칸에만 입력하세요.

05

RISK CONTROL

안전 설정 화면 사용법

운영 모드

LOCKED

모든 주문을 막는 안전 대기 상태입니다. 설정 중, 오류 발생, 전략 미검증 시 사용합니다.

SHADOW

실제 시장 데이터로 신호와 가상체결을 기록하지만 증권사 주문은 보내지 않습니다.

CANARY

승인된 전략만 소액·제한 조건으로 모의투자 API에 주문할 수 있는 단계입니다.

한도 항목

일 최대손실(원)

당일 누적 손실이 이 금액에 도달하면 추가 주문을 막기 위한 한도입니다. 손실 허용 목표가 아니라 절대 상한입니다.

종목당 최대 보유금액(원)

한 종목에 집중될 수 있는 최대 평가금액입니다. 주문당 한도보다 같거나 크게 설정하는 것이 자연스럽습니다.

주문당 최대금액(원)

한 번의 주문이 넘을 수 없는 금액입니다. 수량 × 예상가격 기준으로 검사합니다.

최대 동시보유 수

동시에 보유할 수 있는 서로 다른 종목 수입니다. 무분별한 종목 확장을 막습니다.

분당 최대 주문 수

중복 신호나 프로그램 이상으로 짧은 시간에 주문이 몰리는 것을 막습니다.

Kill Switch

가장 강한 비상정지 장치입니다. 켜져 있으면 다른 조건이 좋아도 주문을 거부합니다.

Shadow 전환 절차

  1. 전략 찾기·검증에서 OOS 통과 후보 확인

    0개라면 아직 전환할 이유가 없습니다.

  2. 한도를 모두 0보다 큰 값으로 입력

    시스템은 한 항목이라도 0이면 Kill Switch 해제를 거부합니다.

  3. 운영 모드를 SHADOW로 선택

    CANARY를 먼저 선택하지 마세요.

  4. Kill Switch 체크 해제 후 저장

    상단 상태가 SHADOW로 바뀌는지 확인합니다. Shadow는 증권사 주문을 보내지 않습니다.

기능 확인용 예시일 뿐 투자 권고가 아닙니다

모의 Shadow에서 일 최대손실 100,000원, 종목당 500,000원, 주문당 200,000원, 동시보유 3개, 분당 2회처럼 보수적인 작은 값으로 흐름을 확인할 수 있습니다. 실제 한도는 자금과 허용 손실에 맞춰 별도로 결정해야 합니다.

예수금이 부족할 때 수량과 종목은 어떻게 정하나요?

Canary 매수 직전에 KIS 주문가능금액을 다시 조회합니다. 여기서 현금 5%, 아직 끝나지 않은 매수주문의 예약금, 수수료·슬리피지 여유 0.3%를 반영합니다. 주문당 최대금액·종목당 남은 한도·실제 가용금액 중 가장 작은 금액을 예산으로 삼아 정수 수량을 계산합니다.

  • 1주 가격이 예산보다 큼: 주문하지 않고 차단 사유를 기록한 뒤 다음 후보를 검토합니다.
  • 여러 매수신호가 동시에 발생: 매도 신호를 먼저 처리하고, 매수는 Shadow 성과·OOS Sharpe·Walk-Forward 안정성·신호 강도·거래대금 순으로 처리합니다.
  • 미체결 주문이 존재: 해당 주문금액을 예약해 같은 돈을 다른 주문이 중복 사용하지 못하게 합니다.
  • 주문 또는 체결이 불명확함: 재주문하지 않고 LOCKED와 Kill Switch로 전환해 대사를 요구합니다.

CANARY 전환은 언제 하나요?

새 종목·기간별 최적화 후보의 기본 심사는 신규 가상 관찰 20거래일·완료 거래 5건 이상과 비용 차감 성과·하락폭·불확실성 기준을 확인합니다. 기존 전략의 5일 관찰 기록을 새 후보의 검증 완료로 대신 인정하지 않습니다. 후보가 시스템에서 CANARY 승인 상태가 아니면 모드를 바꿔도 주문은 거부됩니다.

06

전략 찾기·검증

연구 화면 숫자와 전략 이름 읽는 법

일봉 데이터

연구에 쓰는 전체 일봉 행 수와 날짜 범위입니다. 행 수는 “종목 수 × 거래일 수”에 가까우므로 수십만 건이 정상입니다.

대상 종목

일봉 데이터가 있는 활성 종목 수입니다. 분석 대상 종목와 비슷해야 하며 0이면 연구를 실행하지 마세요.

후보 전략

현재 활성 연구 후보 수입니다. “OOS 통과 n”이 실제 다음 단계 진입 가능성을 뜻합니다.

최근 실행

SUCCEEDED는 연구 작업 자체 성공, 후보 n은 생성 수, 검증 n은 전체 기준 통과 수입니다. SUCCEEDED인데 검증 0은 정상적인 연구 결과일 수 있습니다.

검증 단계 읽는 방법

  1. 후보 생성: 여러 지표와 파라미터 조합을 탐색합니다.
  2. OOS: 후보 선택에 쓰지 않은 데이터에서 다시 성과를 봅니다.
  3. Walk-Forward: 과거에서 선택한 전략을 다음 미공개 구간에 반복 적용합니다.
  4. Shadow: 실제 시세에서 신호와 다음 봉 가상체결을 기록합니다.
  5. Canary: 통과 후보만 제한된 모의투자 주문으로 검증합니다.
  6. 승인: 실전 사용은 자동이 아니라 별도 사람 승인 대상입니다.

통과 기준 용어

OOS Sharpe

보지 않은 구간에서 위험 대비 수익이 얼마나 일관적인지 보는 수치입니다. 높을수록 좋지만 이것 하나만으로 통과하지 않습니다.

MDD / 최대낙폭

고점에서 저점까지 가장 크게 감소한 비율입니다. 수익률이 좋아도 낙폭이 크면 탈락할 수 있습니다.

최소 거래 수

몇 번의 우연한 거래로 성과가 부풀려지는 것을 막습니다. 거래가 너무 적으면 Sharpe가 좋아도 통과하지 않습니다.

Profitable Fold Ratio

Walk-Forward 구간 중 수익 구간의 비율입니다. 특정 시기에만 작동하는 전략을 걸러냅니다.

Regime

상승추세, 하락추세, 횡보, 고변동성처럼 시장 상태를 나눈 것입니다. 한 국면에서만 좋은 전략인지 확인합니다.

Strategy Autopsy

탈락한 이유와 가장 약한 시장 국면을 기록해 다음 후보 개선에 사용합니다.

전략 이름 해석 예시

ALL:ema_cross:fast=10,slow=30

ALL 전체 분석 대상 종목 · ema_cross 지수이동평균 교차 · fast/slow 단기/장기 기간입니다. 이름은 연구 조합을 식별하는 코드이지 종목 추천 문구가 아닙니다.

종목별 전략 적용 근거·목표 읽는 순서

  1. 종목과 버전: 삼성전자처럼 정확한 한 종목에만 적용되는 전략인지, 어떤 검증 버전인지 확인합니다.
  2. 선정 근거: 해당 종목 데이터로 비교한 설정 수, OOS Sharpe·MDD·거래 수와 Walk-Forward 통과 비율을 확인합니다.
  3. 매수·매도 조건: 지표 이름만 보여주지 않고 “어떤 상황에 사고, 어떤 상황에 파는지” 문장으로 확인합니다.
  4. 목표와 위험: 고정 목표가가 있는 전략만 목표가격을 표시합니다. 추세 전략은 임의 목표가를 만들지 않고 청산 조건·기대수익 범위·손실위험을 표시합니다.
  5. 통계 신뢰성: 많은 종목과 설정을 시험해 우연히 좋아 보인 결과인지 FDR 검사와 파라미터 안정성으로 확인합니다.
  6. 유효기간과 단계: Walk-Forward에서 관찰된 성과 지속기간, 데이터 기준일, Shadow 진행일과 현재 승인 상태를 확인합니다.
전략은 종목별로 분리됩니다

종목별 후보가 통과한 경우에만 그 종목에 배정합니다. 증거가 부족한 종목은 거래하지 않습니다. 시장·지수 공통 전략은 후보를 좁히는 연구 자료이며 그대로 전체 종목 주문에 사용하지 않습니다.

유효기간은 어떻게 정하고 중간에 무엇을 보나요?

5분봉 5일, 일봉 20일처럼 고정된 보증기간을 사용하지 않습니다. 각 종목·전략의 Walk-Forward 구간에서 “같은 설정이 OOS 수익을 유지한 연속기간”의 보수적인 하한을 계산합니다. 근거를 계산할 수 없으면 승인 대상이 아닙니다.

  • 최장 사용 가능기간: 계산된 기간이 지나면 자동으로 신규 신호 대상에서 제외합니다.
  • 매 거래주기 중도검사: 분석 대상 종목 제외, 검증되지 않은 시장국면, 데이터 오류와 한도 위반이 생기면 기간이 남아도 즉시 만료합니다.
  • 실제 손익 중도검사: Shadow 실제 낙폭이 OOS 낙폭의 1.5배를 넘거나, 5회 이상 완료된 거래에서 평균수익의 단측 95% 상한조차 0 이하이면 전략 우위가 사라진 것으로 보고 만료합니다.
  • 새 설정 발견: 기존 전략을 바로 덮어쓰지 않고 Challenger 새 버전으로 저장해 OOS → Shadow → Canary 검증을 다시 거칩니다.
  • 승인 변경: 종목, 전략, 설정값 또는 유효기간 근거가 바뀐 버전은 기존 승인으로 대신하지 않습니다.
유효기간은 수익 보증기간이 아닙니다

기간 안이라도 손실한도·낙폭·체결 이상·시장 변화 기준을 위반하면 중단됩니다. 기간을 채웠다는 이유만으로 다음 단계나 실전으로 자동 승급하지 않습니다.

“과거 데이터 연구 다시 실행” 버튼

현재 저장된 데이터를 사용해 후보 생성과 검증을 다시 수행합니다. 자동 실전승급이나 주문은 하지 않습니다. 실행 중에는 반복해서 누르지 말고 최근 실행이 SUCCEEDED 또는 FAILED로 바뀔 때까지 기다립니다.

07

OPERATIONS

계좌·거래·보유·차트 화면 읽는 법

모든 조회 화면은 읽기 전용입니다

계좌조회·거래내역·차트 버튼은 주문을 만들거나 Kill Switch를 해제하지 않습니다. 실전계좌를 선택해도 잔고만 조회합니다.

계좌조회

  1. 모의 또는 실전 계좌를 선택합니다.

    처음에는 모의투자 계좌를 확인합니다. 실전투자에는 “조회만”이라고 표시됩니다.

  2. 계좌 새로 조회를 누릅니다.

    예수금, 주문가능금액, 주식 평가금액, 총 평가금액과 평가손익이 표시됩니다.

  3. 보유잔고를 확인합니다.

    종목별 수량·평균매입가·현재가·평가손익·수익률을 보여줍니다. 종목명을 누르면 차트로 이동합니다.

  4. 증권사 ↔ 시스템 장부 대사를 확인합니다.

    “수량 일치”가 정상입니다. 불일치는 수동 보유종목 때문일 수도 있지만, 원인을 확인하기 전에는 신규 주문을 진행하지 않습니다.

실시간 · 마지막 정상값 · 연동 지연

KIS가 정상 응답하면 실시간으로 표시합니다. 외부 서버가 잠시 응답하지 않으면 마지막 정상 조회값을 명확히 구분해 표시하며, 저장된 값이 없으면 금액을 0원으로 만들지 않고 “-”로 표시합니다. 캐시값은 주문 판단에 사용하지 않습니다.

주문·체결내역

구분

Shadow는 가상신호·가상체결, 모의는 KIS 모의계좌 주문, 실전은 실제 계좌 주문입니다. 서로 섞어 해석하지 마세요.

상태

대기·접수·부분체결·체결·취소·거부·리스크 차단·확인 필요를 구분합니다. “확인 필요”는 재주문하지 말고 증권사 앱에서 먼저 확인합니다.

주문수량 / 체결수량

10 / 4라면 10주를 주문했지만 4주만 체결된 부분체결입니다. 남은 수량을 임의로 다시 주문하지 않습니다.

전략 연결

어떤 전략 버전이 주문을 만들었는지 표시합니다. 전략명을 누르면 설정·근거·유효기간 상세로 이동합니다.

보유종목 상세

평균매입가와 평가손익만 보지 말고, 카드 아래의 선정 근거와 청산 조건을 함께 확인하세요. “전략 연결 없음”은 수동 보유 또는 이전 기록일 수 있으므로 자동전략 보유로 간주하지 않습니다.

  • 차트 보기: 해당 종목의 가격·거래량·전략 지표·신호 위치 확인
  • 전략 자세히: 전략 버전, 설정값, OOS 결과, 유효기간과 탈락 이유 확인
  • 거래내역: 해당 종목으로 검색된 신호·주문·체결 확인

종목 차트

종목명 또는 6자리 종목코드를 입력합니다. 종목명은 한 글자부터 앞부분이 일치하는 후보가 표시되며, 마우스 또는 방향키와 Enter로 선택할 수 있습니다. 종목을 선택한 뒤 전략 ID 입력란을 클릭하면 그 종목에 연결된 활성 전략만 표시됩니다. 전략을 선택하면 해당 전략의 일봉/5분봉도 자동으로 맞춰집니다. 전략 ID를 비우면 선택 종목·봉 종류의 최신 전략을 자동 연결하며, ID를 직접 입력한 경우에도 서버가 종목과 봉 종류의 일치 여부를 검사합니다.

차트에는 상승·하락 캔들, 거래량, SMA 5·20·60 이동평균선이 항상 표시됩니다. 캔들에 마우스를 올리면 해당 봉의 시가·고가·저가·종가·거래량과 각 SMA 값을 확인할 수 있습니다. 마우스 휠 또는 확대·축소 버튼으로 기간을 조절하고, 확대된 상태에서 좌우로 드래그해 과거·최근 구간을 이동합니다. 전체 보기 버튼은 저장된 조회 구간 전체로 돌아갑니다.

빨강·파랑 봉

빨강은 종가가 시가보다 높은 상승 봉, 파랑은 종가가 시가보다 낮은 하락 봉입니다. 아래 막대는 같은 봉의 거래량입니다.

SMA·전략 지표선

보라·주황·청록 실선은 SMA 5·20·60입니다. 자홍 점선은 전략의 빠른선, 파랑 점선은 느린선이며 상단 범례의 색과 차트 선 색이 항상 같습니다.

매수·매도 표시

전략 신호 또는 Shadow 가상체결 위치입니다. 신호는 주문과 다르며, 리스크 차단 상태일 수 있습니다.

마지막 가격

저장된 시세 데이터이며 실시간 호가가 아닙니다. 일봉 화면은 최신 저장 종가, 5분봉 화면은 최근 수집된 5분봉입니다.

전략 자세히

종목별 전략 목록에서 하나를 누르면 선정 근거, 매수·매도 규칙, 목표가 방식, 설정값, OOS Sharpe, 최대낙폭, 거래 수, 설정 안정성, 계산된 유효기간, Shadow·증권사 주문 횟수와 현재 탈락 이유를 표시합니다. 좌측 목록 카드와 우측 상세 카드는 같은 높이로 유지되며, 전략이 많을 때는 좌측 목록 안에서 스크롤합니다.

근거 부족 · 승인 불가

화면 고장이 아니라 유효기간이나 통계 근거가 충분하지 않다는 뜻입니다. 기준을 낮추지 않고 다음 연구를 기다립니다.

수익·손실

시스템에 기록된 체결을 평균단가 방식으로 계산해 누적 실현손익, 수수료, 세금과 손익 후퇴액을 표시합니다. 시스템 시작 전에 수동으로 보유한 주식과 입출금은 추정하지 않으므로 증권사 총 손익과 다를 수 있습니다.

  • 일별 손익: 날짜별 실현손익·누적손익·비용·체결 수
  • 전략별 손익: 어느 전략의 기록된 체결에서 손익과 비용이 발생했는지
  • 감사 이력: 리스크 설정 변경, 연구 실행, Shadow 단계, 안전잠금과 오류 기록
08

VALIDATION

Shadow와 Canary는 달력보다 증거가 우선

대기

OOS 통과 후보 0개

오류가 아닙니다. 검증할 전략이 없으므로 거래하지 않는 것이 정상입니다.

1단계

OOS_VALIDATED 후보 발생

모든 자동 검증 기준을 통과한 후보만 Shadow 신호 생성 대상이 됩니다.

2단계

가상매매로 새 결과 쌓기

새 최적화 후보는 기본 20거래일·완료 거래 5건 이상을 관찰하고 성과·위험 조건을 검토합니다. 기간을 채웠다고 자동 합격하지 않습니다. 일봉은 다음 날 자료 확인 후 반영하며, 휴장일·과거 시험은 새 관찰일로 세지 않습니다.

3단계

Canary 최소 5거래일

승인 후보를 작은 한도로 모의투자 API에 주문하고 주문·체결·잔고 대사를 검증합니다.

최종

실전 승인 여부 결정

사람이 결과를 검토한 뒤 서버의 오프라인 이중 승인으로만 LIVE를 엽니다. 웹 화면에서는 승인할 수 없고, 실전계좌가 비어 있어야 하며 일손실 5만원·종목 20만원·주문 10만원·2종목·분당 1회의 강제 상한을 만족해야 합니다.

“일주일이 지났으니 자동 승급”이 아닙니다

기간을 채워도 거래 수, MDD, 오류, 국면 일관성이 기준을 통과하지 못하면 같은 단계에 머물거나 연구 단계로 돌아갑니다.

09

DAILY ROUTINE

매일 무엇을 확인하면 되나요?

장 시작 전

  • 상단 운영 모드 확인
  • 의도하지 않은 CANARY 여부 확인
  • KIS 연동 오류 알림 확인
  • 한도와 Kill Switch 상태 확인

장중

  • 장중 시세 수집 상태 관찰
  • 오류 알림이 없으면 반복 조작하지 않기
  • 이상 주문이 의심되면 즉시 Kill Switch
  • 증권사 앱 주문내역도 함께 확인

장 종료 후

  • 데이터 갱신 성공 여부
  • 최근 연구 SUCCEEDED/FAILED
  • OOS 통과 수 변화
  • Shadow 신호·가상체결·차단 수 확인
평소에는 관찰이 기본입니다

분석 대상 종목 갱신과 연구 실행은 자동 작업이 담당합니다. 숫자가 정상이라면 버튼을 여러 번 누를 필요가 없습니다.

10

EMERGENCY

이상 상황에서 즉시 정지하는 방법

1분 비상정지 절차
  1. 왼쪽 메뉴에서 안전 설정를 엽니다.
  2. Kill Switch 활성화를 체크합니다.
  3. 운영 모드를 LOCKED로 선택합니다.
  4. 리스크 한도 저장을 누릅니다.
  5. 상단 상태가 LOCKED인지 확인합니다.
  6. 한국투자증권 앱에서 실제 미체결 주문과 잔고를 직접 확인합니다.

네트워크 장애로 사이트 저장이 실패한다면 사이트만 믿지 말고 증권사 앱/웹에서 미체결 주문을 직접 취소하고 계좌 상태를 확인하세요.

11

TROUBLESHOOTING

자주 보이는 오류와 해결 순서

“요청 실패 (500)”이 표시됩니다

서버 내부 처리 중 오류입니다. 같은 버튼을 여러 번 누르지 마세요.

  1. 입력값이 각 칸의 종류와 맞는지 확인
  2. 페이지를 새로고침하고 로그인 상태 확인
  3. 한 번만 다시 시도
  4. 계속되면 오류가 난 메뉴·버튼·시각을 알려주세요. 비밀 값은 보내지 마세요.
“KIS 필수 설정이 모두 저장되지 않았습니다”

선택한 환경의 App Key, App Secret, 계좌번호, 상품코드 또는 HTS ID 중 하나가 없습니다. 증권사·알림 연결에서 해당 그룹이 모두 “설정됨”인지 확인하세요.

KIS 테스트가 401/403 또는 인증 거부로 실패합니다

모의 키와 실전 키를 바꿔 넣지 않았는지, App Key/Secret의 앞뒤 공백, Open API 사용 신청 상태, 계좌번호와 상품코드 분리를 확인하세요. 키를 채팅으로 보내지 마세요.

분석 대상 종목가 정확히 350이 아닙니다

공식 마스터의 구성 변경·처리 시점에 따라 약간 다를 수 있습니다. 0이 아니고 KOSPI200/KOSDAQ150 세부 숫자가 함께 보이면 먼저 자동 갱신을 기다립니다. 장 종료 후에도 크게 다르면 공식 분석 대상 종목 갱신을 한 번 실행하세요.

연구 실행은 SUCCEEDED인데 OOS 통과가 0입니다

작업은 성공했지만 안전 기준을 통과한 전략이 없다는 뜻입니다. 오류가 아닙니다. 기준을 낮춰 억지로 승급시키지 않습니다.

Shadow 신호와 가상체결이 계속 0입니다

먼저 OOS 통과 후보가 있는지 확인하세요. 통과 후보가 없거나 새로운 매수/매도 전환 신호가 없으면 0이 정상입니다. 신호는 발생해도 다음 봉이 들어와야 가상체결됩니다.

리스크 저장이 거부됩니다

Kill Switch를 끄려면 모드가 SHADOW 또는 CANARY여야 하고 모든 한도가 0보다 커야 합니다. 안전을 위해 하나라도 0이면 저장을 거부합니다.

화면 숫자가 갱신되지 않습니다

브라우저 새로고침 후 다시 로그인합니다. 연구 작업은 백그라운드에서 실행되므로 시작 직후에는 이전 숫자가 보일 수 있습니다. 여러 번 실행 버튼을 누르지 마세요.

계좌 대사에 불일치가 표시됩니다

증권사 앱의 실제 수량과 시스템 장부 수량이 다릅니다. 수동으로 보유한 종목도 불일치로 표시될 수 있습니다. 신규 주문을 진행하지 말고 종목별 수량과 미체결 주문을 확인하세요.

차트의 마지막 가격이 증권사 앱과 다릅니다

차트는 저장된 최신 일봉 또는 5분봉을 사용하며 실시간 호가가 아닙니다. 화면의 데이터 개수와 봉 종류를 확인하세요.

손익이 증권사 총 손익과 다릅니다

손익 화면은 시스템에 기록된 체결만 계산합니다. 시스템 시작 전 수동 보유, 외부 주문, 입출금은 포함하지 않습니다. 계좌 전체 손익은 증권사 앱을 최종 기준으로 확인하세요.

Telegram 알림이 오지 않습니다

Bot Token과 Chat ID가 “설정됨”인지, 봇과 대화를 시작했는지, Chat ID가 현재 대화의 것인지 확인합니다. Token을 재발급했다면 새 값만 입력해 교체하세요.

12

GLOSSARY

예시로 이해하는 화면 용어 사전

영어를 외울 필요는 없습니다

각 용어가 “무엇을 확인하기 위한 것인지”와 숫자가 실제로 무엇을 뜻하는지만 이해하면 됩니다. 전략 찾기·검증 화면의 용어사전 링크를 누르면 이 위치로 바로 이동합니다.

전략 검증 용어

Backtest
백테스트
과거 가격으로 “이 규칙대로 거래했다면 어땠을까?”를 계산하는 시험입니다.예: 2023~2025년 삼성전자에 EMA 전략을 적용해 수익과 손실을 계산합니다.
OOS
미공개 구간
전략을 만들 때 일부러 보여주지 않았다가 마지막에 사용하는 시험 데이터입니다. 암기 문제를 푼 학생에게 처음 보는 문제를 주는 것과 같습니다.예: 2023~2025년으로 전략을 만들고 2026년으로 재시험합니다.
Walk-Forward
전진 검증
학습기간과 시험기간을 앞으로 한 칸씩 옮겨 여러 번 시험합니다. 특정 한 시기에만 우연히 성공한 전략을 걸러냅니다.예: 1~6월 학습→7월 시험, 1~7월 학습→8월 시험을 반복합니다.
Fold
검증 구간
Walk-Forward에서 한 번의 학습·시험 묶음을 뜻합니다.예: 7월 시험이 1번 Fold, 8월 시험이 또 다른 Fold입니다.
MDD
최대낙폭
평가금액이 한때의 최고점에서 가장 낮은 지점까지 얼마나 줄었는지 나타냅니다.예: 1,000만원이 1,100만원까지 올랐다가 880만원이 되면 MDD는 20%입니다.
OOS MDD
전략이 처음 보는 OOS 시험기간에서 기록한 최대낙폭입니다. 학습기간 MDD보다 실전 위험 판단에 더 중요합니다.예: OOS MDD 12%라면 시험기간 최고점 대비 최대 12% 하락했습니다.
Sharpe
샤프지수
가격 출렁임을 감수한 것에 비해 수익이 얼마나 꾸준했는지 보는 값입니다. 높을수록 좋지만 거래 수와 MDD도 함께 봐야 합니다.예: 수익은 같아도 매일 크게 출렁인 전략보다 안정적인 전략의 Sharpe가 높습니다.
OOS Sharpe
처음 보는 OOS 구간에서 계산한 Sharpe입니다. 과거 학습 성과가 아니라 재시험의 위험 대비 수익입니다.높아도 거래가 2번뿐이면 신뢰하기 어려워 최소 거래 수 조건을 함께 적용합니다.
Hit Rate
승률
전체 거래 중 수익 거래의 비율입니다. 승률만 높고 한 번의 손실이 매우 크면 좋은 전략이 아닙니다.예: 10번 중 6번 수익이면 승률 60%입니다.
Overfitting
과적합
과거 문제의 정답을 외워 과거에는 좋지만 새로운 시장에서는 실패하는 상태입니다.예: 수백 개 설정 중 과거수익이 가장 높은 하나만 고르면 우연을 선택할 위험이 큽니다.
Trade Count
거래 수
검증기간에 실제로 진입·청산한 횟수입니다. 너무 적으면 수익이 실력인지 우연인지 판단하기 어렵습니다.예: 3년 동안 거래 3번으로 100% 승률인 전략은 통계적으로 불충분할 수 있습니다.
Profitable Fold Ratio
여러 Walk-Forward 시험구간 중 수익을 낸 구간의 비율입니다.예: 5개 Fold 중 3개가 수익이면 60%입니다.

가격·거래량 지표 용어

Indicator
지표
가격이나 거래량을 계산해 시장 상태를 쉽게 판단하도록 만든 숫자·선입니다.지표 자체가 주문이 아니라 전략의 판단 재료입니다.
SMA
단순이동평균
최근 일정 기간의 종가를 똑같은 비중으로 평균낸 선입니다.예: SMA 20은 최근 20개 종가의 단순 평균입니다.
EMA
지수이동평균
최근 가격에 더 큰 비중을 주는 이동평균입니다. SMA보다 최근 변화에 빠르게 반응합니다.예: EMA 8이 EMA 24를 위로 통과하면 상승 전환 후보로 봅니다.
WMA
가중이동평균
최근 값에 선형적으로 더 큰 가중치를 주는 이동평균입니다.예: 5일 WMA는 오늘에 가장 큰 비중, 5일 전 가격에 가장 작은 비중을 줍니다.
VWMA
거래량가중평균
거래량이 많았던 날의 가격에 더 큰 비중을 주는 이동평균입니다.거래가 거의 없던 가격 변화보다 대량거래가 동반된 변화를 중요하게 봅니다.
KAMA
적응형이동평균
시장 소음이 많을 때는 천천히, 추세가 뚜렷할 때는 빠르게 움직이도록 속도를 조절하는 이동평균입니다.횡보장의 잦은 거짓 신호를 줄이는 데 사용합니다.
RSI
상대강도지수
최근 상승과 하락의 힘을 0~100 사이로 나타냅니다. 무조건적인 매수·매도 신호는 아닙니다.예: RSI 30 이하는 과도한 하락 후보, 70 이상은 과도한 상승 후보로 볼 수 있습니다.
ATR
평균진폭
최근 가격이 하루 또는 한 봉에서 얼마나 크게 움직였는지 나타내는 변동성 지표입니다.예: ATR이 커지면 손절폭과 주문 수량을 더 보수적으로 조절할 수 있습니다.
Momentum
모멘텀
현재 가격이 과거보다 얼마나 강하게 오르거나 내렸는지 보는 힘의 방향입니다.예: 현재가가 20일 전보다 10% 높으면 20일 모멘텀은 약 +10%입니다.
Breakout
돌파
가격이 최근 일정 기간의 최고가나 최저가 범위를 벗어나는 현상입니다.예: 최근 20일 최고가를 넘으면 상승 돌파 후보가 됩니다.
Volume Ratio
거래량 비율
현재 거래량이 평소와 비교해 몇 배인지 나타냅니다.예: 거래량 2.0배는 기준 거래량보다 두 배 많다는 뜻입니다.
5분봉 / 일봉
한 개 가격 막대가 담는 시간입니다. 5분봉은 장중 5분, 일봉은 하루의 시가·고가·저가·종가·거래량입니다.5분봉 전략은 빠르고 신호가 많고, 일봉 전략은 느리고 신호가 적습니다.

시장 상태·체결 용어

Regime
시장 국면
현재 시장을 상승추세·하락추세·횡보·고변동성 등으로 분류한 상태입니다.예: 상승장에서 통과한 전략이 하락장에서도 버티는지 별도로 검사합니다.
Adaptive
적응형
시장 국면이나 변동성 변화에 따라 규칙·속도·비중을 조절하는 방식입니다.예: 고변동성에서는 주문 비중을 줄이거나 더 느린 지표를 사용합니다.
ML
머신러닝
여러 가격·거래량 특징과 과거 결과의 관계를 학습해 상승 가능성 등을 확률로 추정하는 모델입니다.확률이 높아도 OOS와 Walk-Forward를 통과해야 합니다.
Slippage
슬리피지
신호를 계산한 가격과 실제 체결 가격 사이의 차이입니다.예: 10,000원 매수를 예상했지만 10,020원 체결이면 20원 불리한 슬리피지입니다.
Fee / Tax
수수료·세금
매수·매도와 매도세금 등 거래 때 빠지는 비용입니다. 백테스트에 포함하지 않으면 수익이 과장됩니다.작은 수익을 자주 내는 전략은 비용 때문에 실제로 손실일 수 있습니다.
Position
포지션
현재 보유하고 있는 종목과 수량을 뜻합니다.예: 삼성전자 10주 보유가 하나의 포지션입니다.
Signal
신호
전략 조건을 만족해 매수 또는 매도 후보가 발생한 상태입니다. 신호가 곧 체결은 아닙니다.리스크 한도에서 거부되거나 다음 봉이 없어 대기할 수 있습니다.
Fill
체결
주문이 시장에서 실제로 거래된 결과입니다. 주문 수량 일부만 체결되는 부분체결도 있습니다.신호 → 주문 → 체결은 서로 다른 단계입니다.
Reconciliation
대사
시스템의 주문·체결·잔고와 증권사 기록이 정확히 같은지 맞춰보는 작업입니다.다르면 신규 주문을 잠그고 원인을 확인합니다.
Buying Power
주문가능금액
현재 계좌에서 신규 주문에 사용할 수 있다고 증권사가 계산한 금액입니다.예수금과 같지 않을 수 있으며 주문 전 증권사 값을 기준으로 확인합니다.
Realized P&L
실현손익
보유주식을 실제로 매도해 확정된 손익입니다.아직 보유 중인 가격 변화는 평가손익이며 실현손익과 구분합니다.
Unrealized P&L
평가손익
현재가격으로 계산한 보유 중 손익으로 아직 확정되지 않았습니다.현재가가 변하면 평가손익도 계속 달라집니다.
Partial Fill
부분체결
주문 수량 중 일부만 거래된 상태입니다.10주 주문 중 4주만 체결되면 체결수량은 4이고 6주는 남아 있습니다.

운영·안전 용어

분석 대상 종목
대상 종목군
연구와 거래 후보로 허용한 전체 종목 집합입니다.현재는 KOSPI200과 KOSDAQ150 구성종목을 사용합니다.
Scanner
종목 스캐너
가격·거래량 조건에 맞는 관찰 후보를 빠르게 추리는 도구입니다. 매수 추천이 아닙니다.모멘텀이 높아도 검증 전략의 신호가 없으면 주문하지 않습니다.
LOCKED
잠금 상태
모든 신규 주문을 차단한 가장 안전한 대기 상태입니다.처음 설정하거나 오류가 있을 때 유지합니다.
Kill Switch
비상정지
다른 조건과 관계없이 주문을 막는 최상위 안전장치입니다.이상 주문이 의심되면 켠 뒤 LOCKED로 저장합니다.
Shadow
가상운영
실제 시세로 신호와 가상체결을 기록하지만 증권사에는 주문하지 않는 단계입니다.전략의 실시간 작동과 비용 차이를 검사합니다.
Canary
제한 검증
승인된 전략을 작은 한도로 모의투자 계좌에 주문하는 단계입니다.주문·체결·잔고 대사가 정확한지 확인합니다.
LIVE 미승인
실제 돈이 있는 계좌에 주문할 권한이 열리지 않은 상태입니다.App Key를 저장하거나 읽기 테스트를 해도 실전 승인이 되지 않습니다.
Candidate
후보 전략
아직 모든 검증을 통과하지 않은 전략 규칙과 설정값 조합입니다.후보가 42개여도 42개를 매수한다는 뜻이 아닙니다.
RESEARCH
후보 전략이 연구 중이며 아직 Shadow 자격을 얻지 못한 단계입니다.화면의 “연구 중”과 같은 의미입니다.
OOS_VALIDATED
OOS·MDD·거래 수·Walk-Forward 기준을 모두 통과한 상태입니다.통과 후에도 바로 실전이 아니라 Shadow 검증을 시작합니다.
13

FAQ

자주 묻는 질문

모의계좌와 실전계좌 중 무엇을 입력하나요?

각각 별도 칸에 입력합니다. “KIS 모의투자” 그룹에는 모의계좌, “KIS 실전투자” 그룹에는 실전계좌를 입력하세요.

실전 App Key를 저장하면 바로 실전 거래하나요?

아닙니다. 저장과 읽기 테스트만으로는 실전 승인되지 않습니다. 현재 화면에서도 LIVE 모드를 선택할 수 없습니다.

연구 후보가 42개면 42개 종목을 사나요?

아닙니다. 후보는 “전략 규칙 조합”입니다. OOS 통과, Shadow, Canary를 거쳐야 하며 대부분은 탈락할 수 있습니다.

OOS 통과 0개면 연구 기준을 낮춰야 하나요?

권장하지 않습니다. 거래를 빨리 시작하려고 기준을 낮추면 과적합 전략이 승급할 가능성이 커집니다. 데이터와 후보군을 개선하되 검증 원칙은 유지합니다.

Shadow 1주와 Canary 1주는 언제 시작하나요?

모든 후보가 같은 날짜에 시작하지 않습니다. 새 최적화 후보는 등록 후 기본 20관찰일·완료 거래 5건 이상과 성과·위험 검토가 필요합니다. 모의투자는 승인 후 최소 5개의 유효 거래일을 확인하고, 체결 표본이 부족하면 더 오래 관찰합니다. 주문 기능 시험은 이 성과 검증과 별도입니다.

사이트를 닫아도 자동 작업이 계속되나요?

네. 자동 수집과 연구 작업은 서버에서 실행되므로 브라우저를 계속 열어 둘 필요가 없습니다.

제가 평소에 꼭 눌러야 하는 버튼은 무엇인가요?

초기 설정 때 암호화 저장과 KIS 테스트가 필요합니다. 이후에는 대부분 상태를 관찰하면 됩니다. 분석 대상 종목 갱신과 연구 실행을 반복해서 누르지 마세요.