5. 자동매매 전략 만들기

자동매매 전략은 부엉이 트레이더 프로의 핵심입니다. "어떤 종목을, 언제, 얼마에, 얼마만큼 사고팔 것인가"를 미리 규칙으로 정의해 두면, 프로그램이 장중에 실시간으로 조건을 감시하며 사용자를 대신해 주문을 냅니다. 이 장에서는 전략을 만드는 세 가지 편집기와, 그 안에서 사용하는 주문 전략·시스템조건식·주문금액식·제외 설정을 순서대로 안내합니다.

5.1 개요

전략은 2계층으로 구성됩니다

부엉이 트레이더 프로의 전략은 매매 전략과 주문 전략 두 계층으로 이루어집니다.

즉, 하나의 매매 전략 안에 "최초매수 1건 + 추가 매수 여러 건 + 매도 여러 건" 식으로 주문 전략을 행(行) 단위로 누적해 나가는 방식입니다.

📌 참고: 이 프로그램에는 매수 탭·매도 탭처럼 화면이 나뉜 구조가 없습니다. 매수든 매도든 모두 하나의 주문 전략(행)으로 만들며, 만든 행이 화면 가운데의 주문 전략 상세 목록에 차곡차곡 쌓입니다.

세 가지 편집기 (종목 선정 방식에 따라 구분)

전략을 만드는 편집기는 종목을 어떻게 고를 것인가에 따라 세 종류로 나뉩니다. 상단 메뉴에서 각각 진입합니다.

💡 팁: 메인 화면의 자동매매 실행 스위치 패널에서 우클릭하면 [단일종목 / 조건검색식 / 사용자 정의] 컨텍스트 메뉴로도 각 편집기를 열 수 있습니다.

📌 참고: 각 편집기 창은 하나만 열립니다. 이미 열려 있는 상태에서 다시 메뉴를 누르면 새 창이 뜨지 않고 기존 창이 앞으로 나옵니다.

세 편집기 차이점 요약

세 편집기는 화면 구성이 거의 같지만, 종목 선정 방식이 달라 일부 항목이 나타나거나 사라집니다.

📌 참고: 표에서 "O"는 해당 편집기에 그 기능이 있다는 뜻입니다. 세 편집기 모두 공통으로 쓰는 화면 구성은 다음 절(5.2)에서, 각 편집기 전용 항목은 5.4~5.6에서 설명합니다.

5.2 공통 화면 구성

세 편집기는 모두 왼쪽 전략 목록 / 오른쪽 전략 상세의 2단 구조를 가집니다. 오른쪽 상세는 다시 위에서부터 전략 헤더 → 주문 전략 상세 목록 → 저장/닫기 버튼 순으로 배치됩니다.

왼쪽: 전략 목록

지금까지 만든 매매 전략들이 목록으로 표시됩니다. 상단 툴바와 행 우클릭 메뉴로 관리합니다.

행에서 우클릭하면 [새로 만들기 / 삭제 / 가져오기 / 내보내기 / AI 분석용 문서 만들기] 메뉴가 나타납니다. 가져오기·내보내기와 AI 분석용 문서는 5.11에서 다룹니다.

⚠️ 주의: 설정 값에 오류가 있는 전략은 목록에서 빨간색 글자로 표시됩니다. 빨간 전략은 정상 동작하지 않으므로, 저장 전에 헤더와 조건을 다시 확인하시기 바랍니다.

📌 참고: 키움 조건검색식 편집기와 사용자 정의 편집기에서는 목록 하단의 ID 표시 체크로 전략마다 부여된 고유 ID를 볼 수 있습니다. 키움 조건검색식 편집기에서는 숨김 전략 표시 체크로 숨긴 전략까지 함께 볼 수 있습니다. (숨김 기능은 5.5에서 설명합니다.)

오른쪽 상단: 전략 헤더

왼쪽에서 전략을 선택하면 오른쪽에 그 전략의 설정이 나타납니다. 헤더에서 전략 전체에 적용되는 공통 항목을 정합니다.

⚠️ 주의: 계좌번호와 이름은 반드시 지정해야 저장됩니다. 계좌번호를 고르지 않으면 어떤 계좌로 주문할지 정해지지 않아 전략이 오류로 표시됩니다.

오른쪽 하단: 저장 / 닫기

• 저장: 현재 전략의 변경 내용을 저장합니다.
• 닫기: 편집기 창을 닫습니다.

⚠️ 주의: 헤더·주문 전략·조건 등을 바꾼 뒤에는 반드시 [저장] 을 눌러야 반영됩니다. 저장하지 않고 창을 닫으면 변경 내용이 사라질 수 있습니다.

5.3 자동 실행 시간 · 자동 완료 · 일괄 매도

전략을 언제 가동하고 언제 마무리할지는 헤더의 시간 관련 설정으로 정합니다. 이 설정들은 세 편집기에 공통으로 있습니다(일부 항목은 편집기별로 유무가 다르며, 아래에 표시했습니다).

자동 실행 시간 (A · B)

헤더 오른쪽의 접이식 자동 실행 시간 섹션을 펼치면, 시간대를 시작~종료 형태로 지정할 수 있습니다. 각 항목은 서로 다른 두 시간대 (A) 와 (B) 를 따로 켤 수 있어, 하루에 두 구간을 운용할 수 있습니다.

💡 팁: 예를 들어 매수는 오전 한 구간에만 하고 매도는 종일 열어 두고 싶다면, 자동 매수 실행 시간에만 좁은 구간을 지정하고 자동 매도 실행 시간은 넓게 지정하면 됩니다.

📌 참고: 주문전략마다 준비·실행조건이 통과할 수 있는 시각을 따로 좁히려면 시간 범위 필터를 사용합니다(5.7.4). 두 설정을 함께 쓰면 겹치는 시간에만 매매가 나갑니다.

진입 요일 제한

자동 실행 시간 섹션 아래쪽의 진입 요일 제한을 체크하고 요일(월 · 화 · 수 · 목 · 금)을 고르면, 고른 요일에만 신규 진입(매매작업 생성) 을 허용합니다. 예를 들어 금요일만 체크하면 다른 요일에는 조건이 맞아도 새 매매작업이 만들어지지 않습니다. 세 편집기에 모두 있습니다.

📌 참고: 추가매수도 같은 요일만은 주문전략으로 나가는 자동 추가매수에만 적용됩니다. 대시보드에서 직접 누르는 [추가매수](7.2.2)와 매도는 어떤 경우에도 요일 제한을 받지 않습니다. 보유 종목을 요일 때문에 청산하지 못하면 손절도 익절도 막히기 때문입니다.

⚠️ 주의: 이 옵션을 켜지 않으면 종전과 같이 추가매수는 요일과 무관하게 나갑니다. "금요일에만 진입" 전략에서 화요일에 물타기 신호가 떠도 그대로 매수되므로, 진입한 요일에만 물량을 늘리고 싶다면 이 옵션을 켜십시오. 요일 선택은 진입과 공유하므로 추가매수 전용 요일을 따로 정할 수는 없습니다.

지정 일시 자동 완료

특정 날짜·시각이 되면 이 전략의 매매작업을 자동으로 마무리합니다.

• 지정 일시 자동 완료 체크 후, N일 후 와 시각 을 지정합니다.

지정 일시 일괄 매도

지정한 날짜·시각에 이 전략으로 보유 중인 종목을 한꺼번에 매도합니다.

• 지정 일시 일괄 매도 체크 후, N일 후 와 시각 을 지정합니다. 새 전략의 기본 시각은 15:15 입니다.
• 주문유형(일괄매도용): 일괄 매도 시 사용할 주문유형과 틱 조정을 함께 지정합니다.

📌 참고: 자동 완료와 일괄 매도의 예약은 매일 다시 등록됩니다. 프로그램을 여러 날 켜 둔 채 운용해도 예약이 사라지지 않습니다.

⚠️ 주의 (v2.3.5) — 일괄 매도는 지정한 그 날에만 실행됩니다. 실행일을 놓치면(그날 프로그램이 꺼져 있었거나 시각이 이미 지났으면) 다음 날 따라잡아 매도하지 않습니다. 뒤늦게 매도하면 예상하지 않은 날짜에 주문이 나가기 때문입니다. 실행일에 프로그램이 켜져 있도록 스케줄러(10장)를 확인하십시오.

📌 참고 (v2.3.5) — 기본 시각 15:30 → 15:15: 15:30~15:40 은 종가 단일가가 끝나고 애프터마켓이 열리기 전이라 주문이 거부될 수 있는 시간대입니다(7.10). 이미 저장한 전략은 저장된 시각을 그대로 사용하므로, 15:30 으로 되어 있다면 직접 바꾸어 주십시오.

당일 매수체결이 없는 경우 자동 완료 처리

당일 장중에 매수 체결이 한 건도 없었다면 매매작업을 자동으로 완료 처리합니다. (키움 조건검색식, 사용자 정의 편집기 전용)

⚠️ 주의: 자동 완료와 일괄 매도는 실제 주문·청산으로 이어지는 설정입니다. 날짜(N일 후)와 시각을 정확히 지정했는지 저장 전에 다시 확인하시기 바랍니다.

5.4 단일종목 편집기

단일종목 편집기는 사용자가 지정한 하나의 특정 종목만 자동매매할 때 사용합니다. 공통 화면 구성(5.2)과 시간 설정(5.3)은 그대로 적용되며, 아래 항목이 이 편집기에만 있습니다.

종목 검색 (돋보기)

헤더에 종목코드와 종목명이 표시되고, 옆의 돋보기 버튼을 누르면 종목 검색 창이 열립니다. 여기서 매매 대상 종목을 골라 지정합니다.

📌 참고: 종목 검색(돋보기)은 단일종목 편집기에만 있습니다. 나머지 두 편집기는 조건검색식이나 내장 방식으로 종목을 자동 선정하므로 종목을 직접 지정하지 않습니다.

이후의 주문 전략·조건·주문금액 설정은 세 편집기가 동일합니다. 5.7 이하를 참고하시기 바랍니다.

5.5 키움 조건검색식 편집기

키움 조건검색식 편집기는 키움 HTS에 등록한 조건검색식이 잡아내는 종목을 자동으로 매매할 때 사용합니다. 공통 구성 외에, 조건검색 기반 운용에 필요한 항목들이 추가로 있습니다.

최초 매수 방법 (포착 / 편입)

이 전략이 종목을 언제 매수 대상으로 삼을지를 결정합니다.

당일 동일 종목 재매수 제한

당일 동일 종목 재매수 제한을 켜면, 그날 이미 매수 이력이 있는 종목은 다시 최초매수하지 않습니다.

📌 참고: 이 제한은 최초매수에만 적용됩니다. 이미 보유 중인 종목에 대한 추가 매수는 영향을 받지 않습니다.

재매수 지연시간 (초)

동일 종목을 다시 매수할 때 최소로 기다릴 시간을 초 단위로 지정합니다.

📌 참고: 재매수 지연시간은 당일 동일 종목 재매수 제한을 켜지 않았을 때 사용합니다. 재매수 제한을 켜면 이 값은 사용되지 않습니다.

잔고 보유 종목 매수 제외

잔고 보유 종목 매수 제외를 켜면, 현재 계좌 잔고에 이미 들고 있는 종목은 신규 매수 대상에서 제외합니다.

📌 참고: 잔고 정보는 계좌 대시보드를 통해 주기적으로 갱신됩니다.

매매 제외 종목 (개별)

헤더 오른쪽 접이식 섹션 중 매매 제외 종목은 특정 종목을 개별적으로 매매에서 빼는 기능입니다. 편집 버튼으로 제외할 종목을 종목코드·종목명 단위로 등록합니다. (자세한 조작은 5.10)

📌 참고: 개별 종목 제외(매매 제외 종목)는 키움 조건검색식 편집기에만 있습니다.

전략 숨기기 · 주문 전략 사용/중지

• 왼쪽 전략 목록에서 우클릭 시 숨김 / 숨김 해제 메뉴로 전략을 목록에서 감추거나 다시 표시할 수 있습니다. 숨긴 전략은 목록 하단 숨김 전략 표시를 켜야 보입니다.
• 오른쪽 주문 전략 상세 목록에서는 행을 우클릭해 사용 / 사용 중지를 토글할 수 있습니다. 사용 중지한 주문 전략은 흐리게 표시되며 실행되지 않습니다.

5.6 사용자 정의 편집기

사용자 정의 편집기는 조건검색식이 아니라 프로그램 밖에서 보내 주는 신호로 종목을 받는 전략에 사용합니다. 어떤 종목을 언제 매매할지는 외부 프로그램이 정하고, 얼마나 어떻게 사고팔지는 주문 전략 설정이 정합니다(13.4).

공통 화면 구성(5.2)과 시간 설정(5.3)은 그대로 적용됩니다. 헤더에는 당일 동일 종목 재매수 제한과 당일 매수체결 없을 시 자동 완료 항목이 있으며, 단일종목 편집기의 종목 검색이나 조건검색식 편집기의 최초 매수 방법(포착/편입) 은 없습니다.

5.6.1 종목 선정 방식

종목 선정 방식은 편집기 헤더가 아니라 주문전략상세 편집 창에서 고릅니다. 준비조건 또는 실행조건의 조건 타입을 사용자 정의로 선택하면 방식을 고르는 콤보가 나타납니다(5.7.4 참고).

⚠️ 주의 (v2.3.4) — 특징주 · 호가창 매매는 동작하지 않습니다. 준비조건의 방식 콤보에는 특징주와 호가창 매매가 아직 표시되지만, 두 방식이 의존하던 내부 데이터 서버 연결이 중단되어 오래전부터 아무 매매작업도 만들지 못하는 상태였고, v2.3.4에서 실행 기능이 정리되었습니다. 이 두 방식을 고른 주문 전략은 조용히 아무 일도 하지 않으므로, 사용 중이라면 외부 전략이나 시스템조건식·키움 조건검색식으로 바꾸십시오. (기존에 저장된 전략을 열 때 화면이 깨지지 않도록 선택지만 남겨 둔 것입니다.)

📌 참고: 실행조건의 방식 콤보에는 처음부터 외부 전략만 나타납니다.

5.6.2 외부 전략

프로그램 외부에서 REST API로 보내는 매매 신호를 조건으로 사용합니다. 다른 프로그램이나 스크립트에서 만든 신호로 부엉이 트레이더 프로의 매매를 촉발할 때 사용합니다.

• 신호를 받을 포트는 [설정 → 시스템 환경 설정] 의 외부신호 수신 항목에서 지정합니다(13.4 참고). 기본값은 15050 입니다.
• 준비조건·실행조건 양쪽 모두 사용할 수 있습니다.
• v2.3.0부터 매도 신호도 받을 수 있습니다. 매도 주문 전략의 준비조건이나 실행조건을 사용자 정의 → 외부 전략으로 두면, 외부가 보낸 매도 신호로 그 주문 전략을 발동할 수 있습니다(13.4).

📌 참고: 외부신호 수신 서버는 같은 PC(localhost)에서 오는 요청만 받습니다. 다른 PC에서 신호를 보낼 수는 없습니다.

5.7 주문 전략 상세

주문 전략은 실제 매수·매도 규칙 한 건입니다. 오른쪽 가운데의 주문 전략 상세 목록에서 추가 또는 수정을 누르면 주문전략상세 편집 창이 열립니다. 이 창에서 매수/매도 구분, 주문 방식, 실행주기, 준비/실행조건, 주문금액을 정합니다.

주문 전략 상세 목록

주문 전략 목록에는 지금까지 만든 주문 전략이 행 단위로 표시됩니다.

📌 참고: 키움 조건검색식 편집기에서는 여기에 실행주기 컬럼이 함께 표시됩니다.

⚠️ 주의: 주문 전략을 삭제한 뒤 다시 등록하면 새 ID가 발급됩니다. 외부 신호로 주문전략을 지정하고 있다면, 전략을 재구성한 뒤 외부 프로그램의 설정값도 함께 갱신하십시오.

목록 툴바로 추가 / 삭제 / 수정 / 가져오기 / 위·아래 이동을 할 수 있습니다. (가져오기는 5.11)

5.7.1 매수/매도 구분과 주문 방식

주문전략상세 편집 창 상단에서 이 주문 전략의 성격을 정합니다.

매수/매도 콤보박스에서 세 가지 중 하나를 고릅니다.

주문 방식은 일반 주문과 복합 주문 중 선택합니다.

• 일반 주문: 주문유형(시장가 / 현재가)을 고르고, 현재가 기준일 때는 틱 간격을 함께 지정합니다.
• 복합 주문: 하나의 주문을 여러 주문유형·틱·비율로 나눠 냅니다. [설정하기...] 버튼으로 세부 설정 창을 엽니다(5.7.5).

⚠️ 주의 (v2.5.0) — 시간외단일가(폐지) 로 표시되는 전략: 시간외단일가 시장이 2026년 9월 14일 폐지되어 주문유형 목록에서 시간외단일가가 빠졌습니다. 이 유형으로 저장해 둔 기존 전략(일괄매도용 주문유형·복합 주문 포함)은 목록에 시간외단일가(폐지) 로 표시됩니다. 전략을 열어도 값이 임의로 바뀌지 않도록 한 것이므로, 직접 다른 주문유형으로 바꾸어 저장하십시오. 그대로 두면 주문이 실패합니다.

📌 참고: 애프터마켓(16:00~20:00)은 시장가 주문을 받지 않습니다. 이 시간대에 시장가 주문전략이 발동하면 엔진이 지정가(매수는 상한가, 매도는 하한가) 로 바꾸어 냅니다(7.10).

📌 참고: 추가 매수는 매수/매도를 매수로 두고, 준비/실행조건에 물타기 조건을 넣어 구성합니다. 아래는 조건반복으로 추가 매수를 설정한 예시입니다.

5.7.2 실행주기와 트리거 대상

실행주기는 조건이 충족될 때 이 주문 전략을 몇 번, 언제까지 실행할지를 정합니다.

매일 — 횟수제한 (총 실행 횟수)

실행주기를 매일로 선택하면 횟수제한 입력란이 나타납니다. 누적 주문 발생 횟수가 지정한 값에 도달하면 해당 주문 전략을 완료 처리하여 반복을 끝냅니다.

• 비워 두면 기존과 같이 무제한으로 매일 반복합니다.
• 예를 들어 5를 입력하면 5거래일에 걸쳐 5회 주문한 뒤 더 이상 실행되지 않습니다.
• 대시보드에서 해당 명세를 수동으로 리셋(실행·준비조건 대기 상태로 되돌림)하면 누적 횟수도 0으로 초기화됩니다.

💡 팁: 분할 매수를 정해진 횟수만큼만 반복하고 멈추고 싶을 때 사용합니다. 무제한 반복을 두면 하락장에서 매수가 계속 쌓일 수 있습니다.

트리거반복을 선택하면 트리거 대상 선택 버튼이 나타납니다. 이 버튼으로 어떤 주문 전략이 완료될 때 이 전략을 재실행할지 대상을 지정합니다.

5.7.3 미체결 처리 · 동적VI 재주문 · 에러 시 매매작업 중지

주문 실행 중 예외 상황을 어떻게 다룰지 정하는 옵션입니다.

⚠️ 주의: 최초매수 주문에서는 에러 발생 시 매매작업 중지가 항상 적용됩니다. 최초 진입 단계의 오류는 이후 추가매수·매도의 전제를 무너뜨리므로 안전하게 중지하도록 되어 있습니다.

미체결 매도를 애프터마켓으로 이전 — 켜기 전에 알아 둘 점

애프터마켓은 정규장 미체결 주문을 이어받지 않습니다. 그래서 이 옵션을 끈 상태(기본) 에서는 정규장에서 체결되지 않은 주문이 15:30 무렵 취소만 되고 다시 주문하지 않습니다. 옵션을 켠 주문전략의 매도 주문만 16:00 에 취소 후 재주문합니다.

• 매도만 이전합니다. 매수는 이전하지 않습니다.
• 재주문 가격은 애프터마켓 현재가에 전략에 설정된 호가 간격(틱) 을 그대로 적용합니다.
• 취소에 실패하면 재주문하지 않습니다. 두 주문이 모두 살아 있으면 이중 체결될 수 있기 때문입니다.
• 애프터마켓에서 거래할 수 없는 종목(ETF·ELW·코넥스 등, 7.10)은 이전 대상에서 빠집니다.

⚠️ 주의: 정규장 내내 체결되지 않은 주문은 대개 가격이 맞지 않는 주문입니다. 애프터마켓은 정규장보다 호가가 얇아 체결 가격이 불리하거나 체결되지 않을 수 있습니다. 의도가 분명한 전략에만 켜십시오.

📌 참고 (v2.5.0): 넥스트레이드가 VI를 단일가매매로 전환하면서 새로 생긴 VI 발동구분 4(VI연장) 값도 인식합니다. 이 값이 와도 동적VI 재주문의 대기 시각을 정확히 계산합니다.

5.7.4 준비조건과 실행조건

하나의 주문은 준비조건이 먼저 충족된 뒤 실행조건이 충족될 때 전송됩니다. 준비조건은 선행 대기 조건, 실행조건은 최종 실행 시점을 정하는 조건입니다.

📌 참고: 준비조건 영역에는 우측 상단에 사용 토글이 있어, 끄면 준비조건 없이 실행조건만으로 주문합니다. 실행조건은 항상 사용합니다.

준비조건·실행조건은 모두 세 가지 유형 중에서 고릅니다.

키움 조건검색식을 고르면 신호를 받는 방식을 다시 선택합니다.

포착 방식에 시각을 지정한 예시는 다음과 같습니다.

⚠️ 주의: 편입+포착은 최초매수 주문 전략에서는 선택할 수 없습니다.

AI 매수의견 사용 — 조건 타입을 키움 조건검색식으로 고르면 그 아래에 AI 매수의견 사용 체크박스와 [설정...] 버튼이 나타납니다. 조건검색식이 충족된 뒤 AI에게 매수 의견을 물어 통과 여부를 결정하는 기능으로, 준비조건과 실행조건에 각각 따로 설정합니다. 자세한 내용은 6장 AI 매수의견 판정을 참고하세요.

📌 참고: 이 항목은 조건 타입이 키움 조건검색식일 때만 나타납니다. 시스템조건식이나 사용자 정의에서는 표시되지 않습니다.

⚠️ 주의 (v2.5.5) — 포착 시각의 허용 범위: 포착 조건검색은 08:00~20:00 사이에 지정한 시각에만 실행됩니다. 종전에는 정규장 기준(09:00~15:30)이 남아 있어, 애프터마켓 개장 뒤에도 17:58·19:58 처럼 15:30 이후로 지정한 포착 검색이 실행되지 않고 건너뛰어졌습니다. 이 범위를 벗어난 시각으로 지정하면 조회 없이 넘어가고 로그에 사유가 남습니다.

시간 범위 (v2.3.6)

준비조건·실행조건 영역 아래쪽에 각각 시간 범위 체크박스와 시작~종료 시각 입력칸이 있습니다. 켜면 지정한 시작~종료 시각 안에서만 그 조건이 통과합니다. 예를 들어 실행조건에 09:00 ~ 10:00 을 걸면, 조건식이 오후에 만족되어도 주문이 나가지 않습니다.

• 시스템조건식·키움 조건검색식·사용자 정의(외부 전략) 세 유형 모두에 똑같이 적용됩니다.
• 전략 헤더의 자동 매수/매도 실행 시간(A·B)(5.3)과는 별개로, 그 안에서 조건별로 한 번 더 제한합니다. 둘 다 설정하면 겹치는 시간에만 매매가 나갑니다.
• 준비조건과 실행조건의 시간 범위는 서로 독립입니다.

⚠️ 주의: 시간 범위를 켰는데 시각을 비워 두면 그 조건은 통과하지 않습니다. 설정 실수가 "전체 시간 허용"으로 조용히 풀려 의도하지 않은 시간에 매매되는 것을 막기 위해서입니다.

5.7.5 복합 주문 세부 설정 · 편입+포착 세부 설정

복합 주문 세부 설정 — 하나의 주문을 여러 갈래로 쪼개 냅니다.

• 각 행마다 주문유형, 틱 간격, 비율(%) 을 지정하고 항목 추가로 갈래를 늘립니다.
• 비율 합이 맞지 않으면 경고 문구가 빨간색으로 표시됩니다.

편입+포착 세부 설정 — 포착 조회 방식을 정합니다.

📌 참고: 어느 방식을 고르든 실시간 편입 수신은 계속 유지됩니다.

📌 참고 (v2.5.5): 세부 설정 창의 안내 문구에는 아직 "정규 거래 시간 09:00 ~ 15:30 내에서만 실행"이라고 표시되지만, 실제로는 08:00~20:00 사이의 지정 시각이면 실행됩니다. 애프터마켓 시각(예: 19:50)으로 지정해도 됩니다.

5.7.6 주문금액 계산식

주문금액 계산식 항목에서 이 주문에 사용할 주문금액식을 고릅니다. 옆의 버튼으로 주문금액식 만들기 창을 열어 새 식을 작성할 수 있습니다(5.9).

편집을 마치면 [확인] 으로 주문 전략을 저장하고, [취소] 로 취소합니다.

⚠️ 주의: 주문전략상세 편집 창에서 [확인] 을 눌러도, 편집기 본 화면에서 다시 [저장] 을 눌러야 전략에 최종 반영됩니다.

5.8 시스템조건식 만들기

시스템조건식은 준비조건·실행조건에서 사용하는 수식 조건입니다. 주문전략상세 편집 창의 [시스템조건식 만들기 (준비, 실행)] 버튼을 누르면 편집기가 열립니다.

조건 단위 입력 (좌항 / 비교연산자 / 우항)

시스템조건식은 하나 이상의 조건 단위로 이루어집니다. 각 조건 단위는 다음 세 가지로 입력합니다.

좌항·우항에는 아래 피연산자를 삽입할 수 있습니다. 각 피연산자 옆의 [L] 버튼은 좌항에, [R] 버튼은 우항에 값을 자동 입력합니다.

피연산자 목록

피연산자는 성격에 따라 6개 탭으로 분류되어 있습니다. (v2.3.5부터 보조지표가 차트 데이터 탭에서 보조지표 탭으로 분리되었습니다.)

탭① 실시간 주식 정보 (16종)

⚠️ 주의 (v2.2.4): 지수 값을 아직 받지 못한 동안에는 그 값을 사용하는 조건이 통과하지 않습니다. 종전에는 미수신 값을 0 으로 취급해 현재가 > 코스피지수 같은 조건이 무조건 참이 되었고, 확인되지 않은 상태로 매수가 나갈 수 있었습니다. 이 변경으로 매수가 이전보다 줄어들 수 있습니다. 지수 계열 피연산자를 쓰지 않는 조건식은 영향이 없습니다.

탭② 차트 데이터 (5종)

탭③ 보조지표

보조지표 탭의 앞쪽에는 기간·승수를 직접 정하는 지표가, 뒤쪽에는 값이 고정된 지표가 나열됩니다.

① 기간·승수를 정하는 지표 (v2.3.5)

지표 이름 옆의 기간·승수 입력칸에 숫자를 넣으면 변수명이 그에 맞게 바뀌고, [L]·[R] 버튼으로 그 변수명이 좌항·우항에 들어갑니다. 변수명을 직접 타이핑하지 않아도 됩니다. 변수 이름에 마우스를 올리면 계산식이 표시됩니다.

• 소수는 마침표 대신 밑줄(_)로 적습니다. 승수 2.5는 2_5 입니다(예: BollingerBands60일2_5상한선). 조건식에서 마침표는 다른 뜻으로 쓰이기 때문입니다. 입력칸에는 2.5 로 넣어도 됩니다.
• ATR 승수(v2.3.6) 는 ATR 값에 곱하는 배수입니다. ATR14일2배 는 ATR × 2, ATR14일1_5배 는 ATR × 1.5 입니다. 승수가 1이면 이름에서 생략되어 ATR14일, ATR30일 처럼 씁니다.
• 주봉 기준 지표(v2.4.2) 는 일봉을 월요일 시작 기준으로 묶어 주봉을 만든 뒤 계산합니다. 진행 중인 이번 주를 가장 최근 봉으로 삼고 실시간 시세를 반영합니다. 기간 상한이 48주인 것은 한 번에 받아오는 일봉 개수에서 계산된 한계입니다.

📌 참고 — 이미 저장한 조건식은 그대로 동작합니다. 파라미터가 이름에 없던 시절의 변수명(BollingerBands이십일이상한선, ATR, 일목균형표_전환선, 일목균형표_기준선, 코스피지수이십일이평선 등)도 계속 인식합니다. 고칠 필요가 없습니다.

⚠️ 주의 (v2.3.5) — 지표 값이 없으면 조건이 통과하지 않습니다. 상장한 지 얼마 안 된 종목에 ATR120일 처럼 계산에 필요한 일봉이 모자라면, 그 변수를 쓰는 조건은 통과하지 않습니다. 종전에는 값 없음을 0 으로 읽어 현재가 > BollingerBands20일2하한선 같은 조건이 근거 없이 통과할 수 있었습니다.

② 값이 고정된 지표

💡 팁: 코스피지수20MA·코스닥지수20MA 를 쓰면 "지수가 20일선 위에 있을 때만 산다"처럼 시장 전체의 흐름을 조건에 넣을 수 있습니다. (예: 코스피지수 > 코스피지수20MA) 기간을 바꾸어 코스피지수60MA 처럼 쓸 수도 있습니다.

탭④ 준비조건 만족 후 (5종)

준비조건이 충족된 이후의 값으로, 주로 실행조건에서 활용합니다.

탭⑤ 최초매수조건 만족 (7종)

최초매수가 이루어진 뒤의 값으로, 추가매수·매도 조건에 활용합니다.

탭⑥ 기타 (6종)

📌 참고: 좌항·우항에는 연산 부호 +, -, *, / 와 괄호 (, ) 를 조합해 최초매수가 * 0.9 같은 수식을 만들 수 있습니다.

조건 조합식 (and / or / 괄호)

조건 단위를 여러 개 만든 경우, 각 단위 사이의 논리 관계를 조합식으로 표현합니다.

시스템조건식 조합 입력란에 직접 쓰거나, [시스템조건식 조합 간편 설정] 버튼으로 기본 조합을 자동 입력할 수 있습니다. 논리연산자는 and, or, 괄호는 (, ) 를 사용합니다.

라이브러리에서 가져오기

목록 툴바의 가져오기를 누르면 시스템조건식 라이브러리에서 가져오기 창이 열립니다.

• 왼쪽 그룹에서 그룹을 고르고, 오른쪽 목록에서 원하는 시스템조건식을 여러 개 선택해 가져올 수 있습니다.
• 선택한 항목의 조건식과 조합이 미리보기로 표시됩니다.
• [확인] 으로 가져오고, [선택 전체 취소] 로 선택을 초기화합니다.

txt 파일로 내보내기

시스템조건식 목록에서 행을 우클릭하면 [txt 파일로 내보내기] 메뉴가 나타납니다. 선택한 조건식의 내용을 텍스트 파일로 저장할 수 있어, 조건식을 백업하거나 다른 사람과 공유할 때 사용합니다.

작성을 마치면 [저장] 을 눌러 시스템조건식을 저장합니다. 저장된 조건식은 주문전략상세 편집 창의 준비/실행조건 목록에 곧바로 나타납니다.

5.9 주문금액식 만들기

주문금액식은 주문 1건의 금액을 계산하는 식입니다. 주문전략상세 편집 창의 [주문 금액 계산식 만들기] 버튼으로 편집기를 엽니다.

용도 (매수 / 매도)

먼저 이 식을 매수용으로 쓸지 매도용으로 쓸지 용도를 고르고, 이름을 입력합니다.

💡 팁: [계산식을 이름으로 사용] 을 켜면 저장 시 계산식 자체가 이름이 되어, 목록에서 식 내용을 바로 알아볼 수 있습니다.

좌항 / 연산자 / 우항

계산식은 한 줄로 입력합니다.

계산식에 사용할 수 있는 변수는 다음 세 가지입니다.

작성을 마치면 [저장] 을 눌러 저장합니다. 저장된 주문금액식은 주문전략상세 편집 창의 주문금액 계산식 목록에서 선택할 수 있습니다.

5.10 매매 종목 필터 및 제외 종목

특정 성격의 종목을 매매에서 빼고 싶을 때 사용합니다. 카테고리 단위 제외는 세 편집기 공통, 개별 종목 제외는 키움 조건검색식 편집기 전용입니다.

매매 종목 필터 (제외 카테고리 7종)

헤더의 매매 제외 카테고리 섹션에서 편집 버튼을 누르면 매매 종목 필터 창이 열립니다. 여기서 제외할 카테고리를 체크합니다.

체크한 카테고리에 해당하는 종목은 매매 대상에서 제외됩니다. [적용] 으로 저장하고 [취소] 로 닫습니다.

매매 제외 종목 (개별)

키움 조건검색식 편집기에서는 헤더의 매매 제외 종목 섹션 편집 버튼으로 특정 종목을 개별 제외할 수 있습니다.

제외할 종목을 종목코드·종목명 단위로 등록하면, 조건검색식이 그 종목을 포착하더라도 매매하지 않습니다.

5.11 전략 가져오기 / 내보내기

만든 전략은 파일로 내보내 보관하거나 다른 곳에서 다시 불러올 수 있습니다.

매매 전략 내보내기 / 가져오기 (JSON)

왼쪽 전략 목록에서 행을 우클릭하면 내보내기와 가져오기 메뉴가 있습니다.

• 내보내기: 선택한 전략을 JSON 파일로 저장합니다. 기본 파일명은 {전략이름}.json 입니다.
• 가져오기: JSON 파일을 선택해 전략을 불러옵니다. 불러온 전략은 현재 선택한 계좌로 편입됩니다.

📌 참고: 가져오기·내보내기는 세 편집기 모두에서 사용할 수 있습니다.

📌 참고 (v2.3.7) — 이름이 겹칠 때: 가져오기 전에 표시되는 매매 전략 가져오기 미리보기 창에서 이름 중복 시 자동으로 이름 변경을 켜 두면, 같은 이름의 전략이 이미 있을 때 이름 뒤에 번호를 붙여 가져옵니다(예: 전략A (2)). 끈 상태에서 이름이 겹치면 바꿀 이름을 보여 주며 이름을 변경해서 가져올지 한 번 더 묻습니다.

AI 분석용 문서 만들기 (v2.3.7)

전략 목록에서 행을 우클릭 → [AI 분석용 문서 만들기] 를 누르면, 선택한 매매 전략의 설정과 조건식을 ChatGPT·Gemini 같은 AI가 읽을 수 있는 Markdown 문서로 만들어 줍니다. "이 전략의 약점이 무엇인지" 같은 질문을 AI에게 할 때 전략 설명을 대신해 붙여넣는 용도입니다.

1. 저장 위치를 고르는 창이 열립니다. 기본 위치는 내 문서, 기본 파일명은 {전략이름}_AI분석자료.md 입니다.
2. 저장하면 같은 내용이 클립보드에도 복사됩니다. AI 채팅창에 바로 붙여넣으면 됩니다. (클립보드 복사에 실패해도 파일은 저장되어 있습니다.)

문서에는 값만 옮기는 JSON 내보내기와 달리 값의 의미가 함께 적힙니다. 매매작업·준비조건→실행조건→주문의 평가 순서, 조건식 문법, 조건식에 실제로 쓰인 변수의 뜻(예: BollingerBands20일2하한선 → 20일 이동평균 − 2 × 표준편차)이 들어갑니다.

📌 참고: 문서 끝의 부록 JSON에서 계좌번호와 사용자 ID는 가려집니다. 또한 키움 조건검색식의 실제 조건 내용은 영웅문에 저장되어 있어 문서에 담기지 않으며, 문서에도 그 점이 명시됩니다. AI가 조건검색식 이름만 보고 내용을 짐작하지 않도록 필요하면 조건 내용을 따로 알려 주십시오.

주문 전략 상세 복사 (다른 매매 전략에서)

주문 전략 상세 목록 툴바의 가져오기를 누르면, 같은 종목 선정 방식의 다른 매매 전략을 골라 그 전략의 주문 전략들을 현재 전략으로 복사해 올 수 있습니다.

⚠️ 주의: 자기 자신과 같은 매매 전략을 선택하면 복사할 수 없다는 경고가 표시됩니다. 서로 다른 전략을 선택하시기 바랍니다.

가져오기 미리보기 읽는 법

대상 전략을 고르면 그 전략의 주문 전략들이 미리보기 표로 나타납니다. 가져오기 전에 내용을 확인할 수 있도록 다음과 같이 표시됩니다.

• 준비조건 · 실행조건의 조건식과 조합은 여러 줄로 나누어 표시됩니다. 이름이나 조건식이 길어도 잘리지 않습니다.
• 조건검색식이 포착 또는 편입+포착 방식이면 이름 뒤에 검색 시간이 함께 표시됩니다. 반복 조회로 설정된 경우 그렇게 표시되므로, 같은 조건식이라도 언제 동작하는지 가져오기 전에 확인할 수 있습니다.

📌 참고: 표를 복사하거나 Excel로 내보내면 화면에 나뉘어 보이던 조건식이 원본 그대로 저장됩니다.

시스템조건식 라이브러리

시스템조건식은 라이브러리에서 여러 개를 골라 가져올 수 있습니다. 자세한 내용은 5.8의 라이브러리에서 가져오기를 참고하시기 바랍니다.