자주 묻는 질문

키움 REST API에서 발급하는 인증 키입니다. 프로그램 계좌 추가 화면에 입력하며 이용자 PC에만 저장됩니다(알고 서버 미보관).

모의·실전은 각각 별도로 발급됩니다. 「구분」과 키가 일치해야 로그인됩니다. 유출되면 키움에서 해지 후 재발급하세요.

이미지 보기 — 계좌 추가 — App Key · Secret Key

Home Trading System — 키움 영웅문 등 PC에서 쓰는 증권 거래 프로그램입니다. 조건식은 HTS에서 만들고, 알고 자동매매는 그 조건식 편입·이탈을 받아 전략으로 매매합니다.

키움의 예전 Windows 연동 방식입니다. HTS/OCX에 의존하고 PC·계좌 구성이 제한적인 경우가 많습니다. 알고 주식자동매매는 REST API를 쓰므로 OCX 설치가 필요 없습니다. 자세한 비교는 「REST API」를 보세요.

정의 — 키움 Open API의 HTTP(REST) 연동 방식입니다. 프로그램이 인터넷으로 시세·잔고·주문을 요청하고 응답(JSON 등)을 받아 처리합니다. OCX 컨트롤 없이도 동작합니다.

장점

• 한 PC에서 여러 계좌를 등록·전환하기 쉽습니다.
• HTS를 켜 두지 않아도(키·IP·서버 정상 시) 자동매매 흐름을 유지하기 쉽습니다.
• 알고 프로그램·웹 안내에 맞춘 발급·계좌 추가 절차가 정리되어 있습니다.

단점·주의

• 등록 IP에서만 인증됩니다. 공인 IP가 바뀌면 키움에 IP를 다시 등록해야 합니다.
• 당일 토큰이 만료되면 재로그인이 필요합니다.
• 키움 서버 점검·장애 시 주문·조회가 멈출 수 있습니다.
• App Key/Secret 유출 위험이 있으므로 PC·파일 보관을 철저히 해야 합니다.

발급·등록 절차: 다운로드 → 키움 REST 발급.

이미지 보기 — 키움 계좌 로그인

이미지 보기 — 계좌 추가

YAML은 사람이 읽기 쉬운 설정 파일 형식입니다. 알고 자동매매에서는 익절·손절·물타기·매수시간 등 매매전략을 *.yaml 파일로 저장합니다.

위치 예: config/trade/strategies/(공유) · config/trade/account_settings/계좌/strategies/(계좌별). 도움 → 매매전략 내보내기/불러오기로 YAML(매매전략)을 zip에 담아 다른 계좌·PC로 옮길 수 있습니다.

SSOT는 Single Source of Truth의 약자로, 기준이 되는 단 하나의 문서·설정을 말합니다. 같은 내용이 여러 곳에 흩어지면 어긋나기 쉬우므로, 공개 조건식·등급·전략 설명은 SSOT(기준문서)를 먼저 고치고 FAQ·매뉴얼을 맞춥니다.

예: 공개 조건식 SSOT(기준문서) — 알고-조건식-배포전략.md (알고대장눌림·알고대장돌파·알고초단타돌파).

마스터가 보낸 매매 신호를 받아, 내 계좌·내 전략으로 따라 매매하는 기능입니다. VVIP(Lv.6) 이상에서 이용합니다. 마스터발송(보내는 쪽)과 별개입니다.

이미지 보기 — VIP 카피매매

VI(Volatility Interruption)는 급등·급락 시 거래소가 잠시 거래를 멈추거나 단일가로 모으는 제도입니다. 이 구간에는 주문이 거절되거나 지연될 수 있어, 프로그램은 일정 시간(쿨다운) 뒤 다시 시도합니다.

쉽게 말해 「종목만 보고, 아직 사지 않는」 단계입니다.

조건식에 종목이 편입·이탈하는지만 추적하고 신규 매수 주문은 넣지 않습니다. 감시 창에서 편입 목록·로그를 확인합니다. 그다음 단계가 「관리」「매매」입니다.

이미지 보기 — 조건식 감시 창

이미지 보기 — 메인 — 조건식 패널

이미 산 종목에 대해 물타기·익절·손절·트레일·이익보전 등 보유 관리·매도 규칙을 돌리는 단계입니다. 매수시간이 지나도 매도시간·당일청산까지 이어질 수 있습니다. 「매매」와 달리 1차 신규 매수는 하지 않는 운용도 가능합니다.

조건식 패널의 매매는 1차(첫) 매수를 허용하는 단계입니다. 매수시간 안에서만 신규 매수가 나가며, 물타기·익절·손절 등은 「관리」 규칙과 함께 동작합니다.

조건식 행의 재시작 체크입니다. 프로그램을 다시 켜거나 자동시작·재로그인 후에도, 종료 전에 켜 두었던 감시/관리/매매 상태를 이어가려는 옵션입니다.

지금 들고 있는 종목과 진행 중인 주문을 보는 탭입니다. 수동 매도·부분 매도·전체 청산이 가능합니다.

구분=수동·전일보유 종목은 우클릭 전략관리(편입가) 또는 전략관리(현재가)로 조건식 전략의 매도 규칙에 연결할 수 있습니다.

이미지 보기 — 수동 종목 — 전략관리

거래중 탭에서 HTS·수동 매수한 종목을 조건식 전략의 매도·청산 규칙으로 넘기는 메뉴입니다.

• 편입가 — 평단(매입가) 기준
• 현재가 — 연결 시점 시세 기준

익절·손절·물타기 등 매도만 적용하며, 조건식 신규 매수를 대신하지 않습니다.

이미지 보기 — 전략관리 메뉴

당일 조건식 자동매매·원스탁 자동매매로 청산이 끝난 거래만 모은 탭입니다. 요약의 매수총액·매도총액·실현손익은 종료된 자동매매만 합산하며, 거래중(미실현) 손익·수동매도는 포함하지 않습니다. 원스탁은 매도(종료) 시점에 매입금액과 손익이 반영됩니다.

이미지 보기 — 거래종료

당일거래내역 — 조건식·원스탁·수동매도를 모두 포함한 당일 보유·매수·매도 내역과 손익 요약.
로그 — 편입·차단·주문 메시지.
거래분석 — 당일 성과를 모아 보는 화면입니다.

이미지 보기 — 당일거래내역

이미지 보기 — 로그

주문을 넣었지만 아직 사지 못했거나(또는 팔리지 않은) 상태입니다. 지정가가 시장가와 멀면 오래 남을 수 있습니다. 미체결 탭에서 취소할 수 있습니다.

이미지 보기 — 미체결

주문이 시장에서 실제로 거래가 성사된 것입니다. 체결되어야 보유 수량·평단·손익이 바뀝니다.

키움 HTS에서 주가·거래량·차트 조건 등으로 종목을 골라내는 검색식입니다. 조건에 맞는 종목이 편입되면 알고 프로그램이 연결된 전략으로 매수·매도를 판단합니다.

조건식 결과에 종목이 새로 들어오는 순간입니다. 이 시점부터(감시·매매 설정에 따라) 매수 후보가 됩니다.

조건식 결과에서 종목이 빠지는 것입니다. 아직 사지 않은 종목의 미체결 매수를 취소하는 등에 쓰입니다.

익절·손절·물타기·불타기·이익보전·트레일링·본전청산·당일청산 등을 묶어 둔 매매 규칙 세트입니다. 조건식 행마다 전략을 연결합니다.

이미지 보기 — 전략 설정

과거 데이터로 「이렇게 매매했으면 어땠을까」를 가상으로 돌려 보는 기능입니다. 원스탁에서 기간 비교·수익 곡선·올청산을 확인한 뒤 실매매를 권장합니다.

이미지 보기 — 전략테스트

이미지 보기 — 수익 곡선

이미지 보기 — 올청산 상세

기본보유 이후 어떤 매도 규칙을 먼저 볼지 정하는 설정입니다.

• 이익보전우선 — 설정 이익%에 오면 이익보전 매도를 앞세움
• 트레일링스탑우선 — 익절·트레일링으로 수익을 더 가져가려는 쪽
• 본전청산우선 — 본전 근처면 청산을 앞세움

매수 체결 후 몇 분은 우선청산(이익보전·본전청산)을 느슨하게 두고, 그 전에는 급등 익절·트레일링을 먼저 보는 대기 시간입니다. 짧으면 빨리 확정, 길면 수익을 더 열어 두는 운용에 가깝습니다.

매수·매도를 자동/수동으로 나눈 조합입니다. 수동이 포함된 쪽은 거래중 탭에서 직접 처리합니다.

매수시간 — 신규(1차) 매수를 허용하는 시간대. 보통 장 초반~장중으로 둡니다.
매도시간 — 익절·손절·관리 매도가 동작하는 시간대입니다. 매수시간이 끝나도 관리·매도는 이어질 수 있습니다.

쉽게 말해 「이익이 났을 때 파는 것」입니다.

전략에 정한 익절%(또는 분할익절 단계)에 수익률이 도달하면 매도해 수익을 확정합니다. 선지정가 주문을 쓸 수 있는 경우가 있습니다.

쉽게 말해 「손실이 나도 더 커지기 전에 파는 것」입니다. 주식을 산 가격보다 낮은 가격에 되팔아 손실을 확정·제한합니다.

전략의 손절%(또는 분할손절)에 도달하면 매도합니다. 이 프로그램에서 손절 기준은 첫 매수가를 쓰며, 물타기로 평단이 내려가도 손절가는 내려가지 않습니다. 손절은 실시간 판단이며 손절용 선지정가는 쓰지 않습니다. 물타기 구간과 겹치면 설정에 따라 물타기가 먼저일 수 있습니다.

주가가 내려갈 때 더 싸게 추가 매수해 평균 단가(평단)를 낮추려는 방법입니다. 2~5차 단계·트리거%·비중을 전략에서 정합니다. 손실이 커질 위험도 있어 한도와 손절을 함께 봐야 합니다.

주가가 올라갈 때 한 번 더 사서 상승에 비중을 실으려는 추가 매수입니다. 트리거·비중·불타기 후 본전청산은 전략·FAQ 「불타기」를 참고하세요.

본전(평단 근처)까지 돌아오면 「이득도 손실도 거의 없이」 포지션을 정리하는 매도입니다. 기본보유(분)이 지난 뒤 적용되는 경우가 많습니다.

기본보유가 지난 뒤, 평단 대비 수익률이 설정한 이익 %에 도달하면 매도해 수익을 잠그는 규칙입니다. 「익절」과 비슷한 느낌이지만, 전략상 우선청산·선호타입과 묶여 동작합니다.

이익이 난 뒤 최고점 대비 일정 %p만큼 빠지면 파는 추적 매도입니다. 「더 오를 때까지 버티되, 꺾이면 수익을 지키는」 방식입니다.

평균 매수 단가입니다. 여러 번 나눠 사면 평단이 바뀝니다. 익절·이익보전·트레일링은 보통 평단을 보지만, 손절 트리거는 첫 매수가를 유지합니다.

종목 수익률이 매우 높아지면(예: +29% 근처) 전략 익절과 별도로 전량 매도하는 안전망입니다. 상한가·급등 청산과 비슷한 목적입니다.

설정한 시각에 보유 종목을 오늘 안에 전부 정리(전량 매도)하는 규칙입니다. 밤새 리스크를 줄이려는 운용에 씁니다.

전일 종가보다 내려간 음봉이면 손절·익절보다 우선해 전량 매도하는 옵션입니다.

계좌(또는 프로그램) 하루 단위 안전장치입니다. 실현 손실이 한도에 닿으면 신규 매수를 막고 보유를 정리(로스컷)하고, 반대로 하루 이익 한도에 닿으면 더 이상 욕심내지 않도록 막는(당일 익절) 설정입니다. 자동매매 기본설정에서 봅니다.

정규장(09:00~15:30)이 끝난 뒤 종가·시간외 단일가 등으로 남은 물량을 정리하는 매도 옵션입니다.

전체청산 — 그 종목(또는 선택 종목)을 전부 팜.
부분매도 — 수량만 나눠 팜. 거래중 탭·확인 창에서 실행합니다.

이미지 보기 — 매도 확인

목표가에 미리 지정가 주문을 걸어 두는 방식입니다. 익절·물타기 등에 쓸 수 있고, 손절은 선지정가 없이 실시간 판단만 합니다.

지금 시장에서 사고팔자고 나온 가격·수량 목록입니다. 지정가·시장가 주문은 호가에 맞춰 체결됩니다.

예수금 — 계좌에 남아 주문에 쓸 수 있는 현금성 금액.
평가자산 — 보유 주식의 현재가 평가액 등.
총손익 — 당일·평가 손익 요약입니다. 대시보드 상단 카드에 표시됩니다.

프로그램 화면의 보유·미체결과 키움 계좌 상태를 맞춰 보는 과정입니다. 수동으로 팔았거나 API 응답이 어긋날 때 거래종료·보유 표시가 정리됩니다.

조건식 편입·틱·세션을 CSV·로그로 남기는 추적 자료입니다. 자동매매 기본설정 → Track CSV 저장으로 켭니다.

키움전략분석·장후 조건식 비교·버그 제보(거래다운로드 zip)에 사용합니다.

키움 가상 돈(사이버머니)으로 연습하는 계좌입니다. 주문·체결 흐름은 실전과 비슷하게 익힐 수 있지만, 실제 출금·입금은 없습니다. 수수료·체결감은 실전과 다를 수 있습니다. 처음에는 분석기본으로 1주 기록을 쌓고, 모의 2주 이상 확인한 뒤 실계좌 소액을 권합니다. 「실거래」항목에서 비교를 보세요.

이미지 보기 — 계좌 추가 — 모의/실전 구분

키움 실제 계좌·실제 돈으로 사고파는 매매입니다. 정회원 Pro(Lv.3) 이상·유효 이용 기간이 필요합니다.

모의투자와의 차이

• 모의: 가상 자금 · 실금 손익 없음 · 연습·검증용
• 실전: 실제 손익 · 세금·수수료 발생 · 출금 가능
• 체결·호가·심리도 실전이 더 빡빡할 수 있습니다.

키움 기준 수수료 차이(국내주식·안내 수준, 변경 가능)

• 실전(온라인 HTS/API 등) — 국내주식 위탁수수료가 대략 0.015% 전후(KRX 등 매체·이벤트·협의에 따라 다름). 매도 시 증권거래세 등이 따로 붙습니다.
• 모의투자 — 키움 모의 시스템에 매매수수료 약 0.35%가 적용되는 것으로 안내됩니다(무위험 호가차익 방지 등). 실전보다 훨씬 높게 잡혀 있어, 모의 수익률을 그대로 실전에 대입하면 안 됩니다.

정확한 요율·세금은 키움증권 공식 「수수료·제비용」 안내와 본인 계좌 적용 조건을 확인하세요.

Windows 작업 스케줄러에 등록해, 평일 아침(기본 08:30) PC가 켜져 있으면 프로그램을 자동 실행하고, 시간외청산 반영 후 16:05에 종료하는 기능입니다.

프로그램 파일 → 자동시작을 체크하면 스케줄이 등록됩니다. 로그인 화면의 「아이디 저장」만으로는 스케줄러에 등록되지 않습니다. PC가 꺼지거나 절전이면 08:30에 실행되지 않습니다.

이미지 보기 — 파일 메뉴 — 자동시작

이미지 보기 — 자동시작 스케줄 안내

이미지 보기 — 자동시작 해제 안내

사전 필터 — 가격대·위험종목 등으로 편입 직후 매수 대상을 걸러냅니다.
블랙리스트 — 지정한 종목은 조건식에 들어와도 절대 사지 않음.

이미지 보기 — 사전 필터링

이미지 보기 — 설정 메뉴

투자유의·투자경고·관리·거래정지·상장폐지우려 등 키움이 표시하는 주의 종목입니다. 「위험종목제외」를 켜면 이런 종목은 매수만 막고, 이미 산 것의 매도는 가능합니다.

이미지 보기 — 위험종목제외

설정 → 자동매매 기본설정… — 전략(조건식별)과 별도인 계좌 공통 한도·습관입니다. 회원 등급 한도(0=무제한)가 로그인 시 반영됩니다.

숫자·한도

• 매수타입(금액/비율) · 매실행 로스컷% · 매실행 익절% · 시작잔고
• 감시 조건식 수 · 최대 보유종목수 · 당일 총 매수종목수 · 당일 주문금액 한도
• 본전정의% · 매수/수동매도 미체결취소(초)

체크 옵션

• 당일 매도 종목 재매수 금지 · 손실 재매수 금지 (계좌 전체)
• Track CSV 저장 — 편입·틱 저장 (키움전략분석·장후 분석용, 기본 ON 권장)
• 매매 시작 시 잔고 스냅샷 · 이탈 종목 제외(미체결만 취소)
• 재실행 시 보유 자동매매 연결 · 로그아웃·재로그인 시 감시·관리 복원
• 보유 중 추가매수 금지 · 거래정지 종목 거래중 미표시
• 코스피급변시손실방지 — 전일종가→금일시가 갭 시 매수금액 축소 (기본 ON)

조건식별 익절·손절·물타기는 전략 설정…, Track 통계·AI추천은 키움전략분석…입니다.

이미지 보기 — 자동매매 기본설정

이미지 보기 — 설정 메뉴

설정 → 키움전략분석…(로그인 화면 버튼 동일).

• Track 감시 궤적으로 조건식별 수익/손실·손절시각·물타기·보유시간·승률을 분석
• 조건식마다 통계를 보여 주고, 개선이 필요할 때만 AI추천
• 분석 결과는 조건식 전부 표시 — 시간대 로스율·보유·물타기·손절 집중 등 기존 설정의 문제점과 조정 권고 포함
• 최종 조건식·전략(1~2개)은 사용자가 선택 — 강제 1개 교체 없음
• HTS 조건식은 변경하지 않음 · 1거래일부터 가능 (권장 1주 Track 후 AI 매매전략 시험)

원스탁 전략테스트와는 별개입니다.

이미지 보기 — 설정 메뉴

이미지 보기 — 키움전략분석 — 실행

이미지 보기 — 키움전략분석 — 분석 결과

설정 → 자동매매 기본설정 체크 (기본 ON). 전일종가→금일시가 갭이 임계(최근 10일 |갭| 기준 자동) 이상이면 당일 매수금액을 줄입니다.

• 급등계(물타기 2단+): 상승갭 약 40% / 하락갭 100%
• 스윙(물타기 0~1단): 상승·하락갭 약 70%
• 계좌 공통 — 조건식·원스탁 신규 매수에 반영 (급락 전용 가드와는 별개)

이미지 보기 — 자동매매 기본설정

한 종목만 골라 조건식 없이 전략으로 매매하는 기능입니다. 조건식(다종목)과 목적이 다릅니다. 자동매매 시작(데모)은 Lv.2 정회원부터, 실거래 계좌 연동은 Lv.3 정회원 Pro부터입니다.

이미지 보기 — 원스탁 — 금액·종목

이미지 보기 — 원스탁 감시

본인 조건식·수동 종목 신호를 서버로 보내 VIP 구독자에게 전달하는 발송 기능입니다. Lv.7 마스터발송 등급에서 이용합니다. 카피 수신(VVIP)과는 별개입니다.

이미지 보기 — 마스터 발송

키움 REST 로그인 성공 시 받는 당일 사용권한 키입니다. 만료되면 주문·조회가 막히므로 프로그램에서 키움 재로그인이 필요합니다.

시장·종목이 급락할 때 손실을 키우지 않도록 빠르게 매도·매수 중단하는 방어 로직입니다. 전략·기본설정의 관련 옵션과 함께 동작합니다.