Chapter 7 / 14

7. 자동매매 실행 및 모니터링

매매전략을 만들었다면 이제 실제로 실행하고, 어떻게 매매가 진행되는지 지켜볼 차례입니다. 이 장에서는 전략을 켜고 끄는 방법, 진행 중인 매매작업을 실시간으로 살펴보는 방법, 그리고 주문·수익률·매매제한을 조회하는 여러 화면을 차례로 안내합니다.

7.1 자동매매 시작·중지

자동매매는 매매전략 단위로 켜고 끕니다. 메인 화면 좌측의 [자동매매 실행 스위치] 패널(3.4에서 소개)에서 전략별 토글 스위치를 눌러 즉시 ON/OFF 할 수 있으며, 편집기를 열 필요가 없습니다.

7.1.1 전략을 켤 때 — 실행 전 순차 검증

전략 스위치를 ON으로 전환하면 프로그램이 곧바로 매매를 시작하지 않고, 먼저 아래 세 가지를 순서대로 검사합니다. 하나라도 통과하지 못하면 스위치는 자동으로 OFF로 원복되고 안내 메시지가 표시됩니다.

순서검증 항목통과하지 못하면
1실시간 주식 체결 등록 한도 — 실시간 체결 데이터를 받을 수 있는 종목 수 한도를 넘지 않는지 확인"실시간 주식 체결 데이터 서비스에 등록할 수 있는 종목코드의 최대 갯수를 초과했습니다…" 메시지 후 원복
2조건검색식 등록 한도 — 실시간 조건검색식 등록 개수 한도를 넘지 않는지 확인"조건검색 서비스에 등록할 수 있는 종목코드의 최대 갯수를 초과했습니다…" 메시지 후 원복
3포착 조건검색식 충돌 — 이 전략의 포착 조건검색식이 이미 실행 중인 다른 전략에서 편입 조건검색식으로 쓰이고 있지 않은지 확인"포착 조건검색식 : '…' 가 이미 실행중인 자동매매전략에서 편입 조건검색식으로 사용되고 있습니다…" 메시지 후 원복

세 검증을 모두 통과하면 전략이 실행 상태로 저장되고, 실시간 체결 데이터와 편입 조건검색식이 등록되면서 자동매매 감시가 시작됩니다.

📌 참고: 위 1·2번의 한도는 키움 REST API의 계좌별 한도를 따릅니다. 프로그램이 사용할 수 있는 상한(실시간 체결 종목 수, 실시간 조건검색식 개수)은 화면 하단 등록 현황 바와 [매매제한 현황] 창(7.8)에서 실시간으로 확인할 수 있습니다. 현재 사용량이 한도에 가까울수록 새 전략을 켜기 어려워지므로, 한도가 넘칠 때는 사용하지 않는 전략을 먼저 중지하십시오.

💡 팁: 스위치 목록에는 사용중이면서 오류가 없는 전략만, 그리고 현재 선택한 계좌에 연결된 전략만 표시됩니다. 켜려던 전략이 보이지 않는다면 계좌 선택, 사용 여부, 오류 상태를 먼저 확인하십시오. 또한 등록된 실제 계좌가 아니면 해당 전략은 오류 상태로 전환되며 "…계좌번호가 존재하지 않습니다." 메시지가 표시됩니다.

7.1.2 전략을 끌 때 — 장중 중지 경고

이미 실행 중인 전략을 장중에 OFF로 전환하면 다음 확인 경고가 표시됩니다.

"장중에 실행을 중지하면 처리되지 못한 매매 데이터가 발생할 수 있습니다. 이로인해 예기치 못한 오류가 발생할 수 있습니다. 계속 진행하시겠습니까 ?"

  • [예] 를 선택하면 즉시 전략이 중지됩니다. 이때 이미 접수된 주문은 자동으로 취소되지 않으며, 이후 체결 이벤트에 대한 후속 처리가 누락될 수 있습니다.
  • [아니오] 를 선택하면 스위치가 원래 ON 상태로 돌아가고 매매가 계속됩니다.

⚠️ 주의: 갑작스러운 장중 중지는 미체결 주문이나 잔고 불일치를 유발할 수 있습니다. 가급적 보유 종목과 미체결 주문이 없는 상태에서, 또는 장 마감 후에 중지하시기를 권장합니다.

7.2 메인 현황 대시보드에서 모니터링

전략을 실행하면 조건에 포착된 종목마다 **매매작업(Job)**이 생성됩니다. 이 매매작업들이 어떻게 진행되는지는 메인 화면 우측에 상시 표시되는 자동매매 현황 대시보드에서 실시간으로 확인합니다. 이 대시보드가 주된 모니터링 수단입니다.

메인 화면 진행 중 매매작업 대시보드

화면은 크게 두 부분으로 나뉩니다. 좌측은 진행 중인 매매작업 목록과 필터·액션 버튼, 우측은 선택한 작업의 명세 / 주문 / 체결을 위에서 아래로 3단으로 보여주는 드릴다운 영역입니다.

7.2.1 진행 중 매매작업 목록

좌측 상단 헤더에는 진행 중 작업 수를 나타내는 카운트 칩, 행 배경색의 의미를 알려 주는 상태 색상 범례, 그리고 [설정] 버튼이 있습니다. [금일 완료작업 표시] 와 [자동 새로고침](5초 주기), 그리고 컬럼 표시 여부는 설정 버튼으로 여는 진행 중 매매작업 설정 창에서 조절합니다. (3.5.1 참고)

바로 아래 필터 패널에서 전략명과 계좌번호를 골라 원하는 작업만 추려 볼 수 있고, [새로고침] 버튼으로 즉시 다시 불러올 수 있습니다.

목록(표)에는 다음 컬럼이 표시됩니다.

컬럼설명
(체크박스)작업 선택. 헤더의 체크박스로 전체 선택
계좌번호작업이 속한 계좌
종목코드매매 대상 종목 코드
종목명종목명. 매도가 중지된 작업에는 매도중지 빨간 배지가 붙음
매매전략작업을 생성한 전략 이름
현재가실시간 현재가. 상승 ▲ / 하락 ▼ 부호와 색상 표시
보유수량 / 매입단가 / 매입금액계좌 잔고 기준 보유 현황
평가금액 / 손익률 / 평가손익현재가로 평가한 금액과 손익
생성일시작업이 생성된 일시

💡 팁: 행 배경색으로 상태를 빠르게 구분할 수 있습니다. 오류는 빨강, 완료는 파랑, 미사용은 옅은 회색(흐리게), 매수대기(최초매수 미체결)는 주황입니다. 손익은 글자색(이익 빨강 / 손실 파랑)으로 표시되어 상태 색과 겹치지 않습니다.

7.2.2 작업 액션 (하단 버튼 · 우클릭 메뉴)

목록에서 작업을 선택한 뒤 하단 버튼이나 우클릭 메뉴로 아래 동작을 실행합니다.

액션동작
사용선택한 작업을 사용 상태로 전환(매매 재개)
사용중지선택한 작업을 사용 중지(매매 중단)
매도중지선택한 작업의 매도중지 상태를 토글. 중지 시 매도주문이 실행되지 않음
일괄 선택 ▾조건에 맞는 작업을 목록에서 한 번에 선택 — 최초매수 미체결 작업 / AI 기각 작업(6.9)
추가매수작업 1개만 선택했을 때 사용. 금액 입력 창이 뜨고, 입력한 금액만큼 시장가로 추가 매수
완료선택한 작업을 완료 처리. 완료된 작업은 보유 종목수 제한에서 빠짐
삭제 ⚠️선택한 작업을 삭제
일괄매도 ⚠️선택한 작업의 보유수량을 지정한 비율만큼 즉시 매도. 설정 창에서 매도 비율(%), 주문 유형(시장가 / 지정가), 호가 Tick 조정을 고릅니다. 100%면 전량 매도하고 해당 작업을 마무리합니다
에러 초기화작업의 오류 상태를 해제

⚠️ 주의: 삭제와 일괄매도는 되돌릴 수 없는 파괴적 동작입니다. 특히 일괄매도는 선택한 모든 작업의 보유 물량을 지정한 비율만큼 즉시 처분하므로, 실행 전에 선택된 작업과 종목을 반드시 다시 확인하십시오.

거래 시간 — 20:00 까지 (v2.5.0)

일괄매도와 추가매수는 영업일 20:00 까지 동작합니다(종전 15:30). NXT에서 거래되지 않는 KRX 전용 종목은 09:00~20:00 밖에서 누르면 "매매 가능 시간이 아닙니다" 안내와 함께 실행되지 않습니다.

애프터마켓 시간(16:00~20:00)에 누르면 실행 전에 확인 창이 먼저 뜹니다.

지금은 애프터마켓(16:00~20:00) 시간입니다. 애프터마켓은 시장가 주문을 받지 않아 일괄매도 주문이 지정가(매도는 하한가, 매수는 상한가)로 나갑니다. 정규장보다 호가가 얇아 체결 가격이 불리하거나 체결되지 않을 수 있습니다.

(일괄매도에서 지정가를 골랐다면 "지정가로 나갑니다"라고만 안내합니다.) 내용을 확인한 뒤 [예] 를 눌러야 주문이 나갑니다. 추가매수는 애프터마켓에서 거래할 수 없는 종목(ETF 등, 7.10)이면 주문 전에 걸러집니다.

📌 참고: 여러 건을 한 번에 삭제하거나 완료 처리하면 대상 목록을 보여 주는 확인 창이 뜹니다. 항목이 많아도 목록 부분만 스크롤되고 버튼은 항상 보입니다.

7.2.3 우측 드릴다운 — 명세 / 주문 / 체결

좌측에서 작업을 선택하면 우측 3단에 그 작업의 세부 내역이 연동되어 나타납니다.

우측 상단 — 매매작업 상세(명세) 선택한 작업에 적용된 주문 전략 명세(최초매수·추가매수·매도 등 단계별 설정)가 나열됩니다. 준비·실행·주문구분·거래구분·주문금액과 함께 준비 조건·실행 조건의 통과/대기 여부, 사용여부, 완료여부, 사용중지이유, 오류 및 오류 메시지가 표시됩니다. 헤더 우측의 범례로 행 배경색의 의미(준비통과=주황, 실행통과=초록, 완료=파랑, 오류=빨강, 미사용=회색)를 확인할 수 있습니다.

명세 행에서 우클릭하면 다음을 실행할 수 있습니다.

  • 사용 시작 / 사용 중지
  • 실행조건 대기중으로 변경 — 실행 조건을 다시 대기 상태로 되돌림
  • 준비조건 대기중으로 변경 — 준비 조건을 다시 대기 상태로 되돌림

우측 중단 — 주문 선택한 작업에서 발생한 주문 목록입니다. 종목코드·종목명·주문구분·거래구분·생성일·주문시간·주문수량·주문가격·체결수량·미체결수량·주문번호·처리상태를 표시하며, 취소된 주문은 회색으로 나타납니다. 우클릭으로 주문을 삭제할 수 있습니다.

우측 하단 — 체결 선택한 작업의 실제 체결 내역입니다. 종목코드·종목명·주문구분·체결수량·체결가격·체결시간·체결번호를 표시합니다. 하나의 주문이 여러 건으로 나뉘어 체결될 수 있습니다.

📌 참고: 좌측 목록 아래에는 접이식 선택한 매매작업 상세 정보 영역이 있어, 펼치면 전략명·사용여부·완료여부·오류여부·주문금액·생성일시·사용중지사유·오류메시지를 한눈에 볼 수 있습니다.

7.3 매매작업 상세창

메인 대시보드에서 행을 더블클릭하면 더 자세한 별도 상세창이 열립니다. 더블클릭 위치에 따라 두 종류의 창이 있습니다.

⚠️ 주의: 이 더블클릭 상세창들은 메인 임베드 대시보드(7.2)에서만 열립니다. 뒤에서 설명하는 별도 [자동매매 현황] 창(7.4)에는 더블클릭 상세창이 없습니다.

7.3.1 매매작업 상세 — 포지션형

진행 중 매매작업 목록(좌측)에서 작업 행을 더블클릭하면 포지션·평가 중심의 상세창이 열립니다. 계좌 잔고를 기준으로 보유 현황과 손익을 한 화면에 정리해 보여주며, 현재가는 실시간으로 반영됩니다.

매매작업 상세창(포지션형)

상단 포지션/평가 박스에는 다음 항목이 표시됩니다.

항목설명
보유수량현재 보유 중인 수량
현재가실시간 현재가
매입단가평균 매입 단가
매입금액매수에 들어간 총 금액
평가금액현재가 × 보유수량
손익률손익 비율(%), 부호에 따라 색상 표시
평가손익평가금액 − 매입금액, 부호에 따라 색상 표시

그 아래 상세 필드 박스에는 전략명·사용여부·완료여부·오류여부·주문금액·생성일시·사용중지사유·오류메시지·기타가 표시됩니다.

📌 참고 (v2.3.6) — "기타"에 남는 매수 시점 보조지표: 최초매수 주문이 나갈 때 판정에 쓰인 보조지표 값(볼린저밴드·ATR 등 조건식이 실제로 참조한 것만)이 기록되어 기타 항목에 표시됩니다. 나중에 다시 계산한 값이 아니라 그 순간 판정에 쓰인 값 그대로이므로, "왜 이 종목을 샀는지"를 되짚어 볼 때 사용합니다. v2.3.6 이후의 매수부터 기록됩니다.

7.3.2 매매작업 상세 — 명세형(2×2 카드)

매매작업 상세(명세) 목록(우측 상단)에서 명세 행을 더블클릭하면, 넓은 명세 표를 읽기 쉽게 2×2 카드 4개로 정리한 상세창이 열립니다.

카드담긴 내용
기본 (좌상)주문구분 · 거래구분 · 실행주기 · 주문금액
상태 (우상)사용여부 · 완료여부 · 오류 · 오류 메시지 · 사용중지이유 · 생성일시
준비 조건 (좌하)유형 · 조건식 · 조합 · 사용자정의 · 통과 여부(통과/대기)
실행 조건 (우하)유형 · 조건식 · 조합 · 사용자정의 · 통과 여부(통과/대기)

💡 팁: 준비 조건과 실행 조건이 모두 통과 상태여야 해당 주문이 실제로 발송됩니다. 주문이 나가지 않는다면 이 두 카드의 통과 여부를 먼저 확인하십시오.

7.4 자동매매 현황 (별도 창)

메인 대시보드 외에, 자동매매 전체 계층을 한 창에서 넓게 보고 싶을 때는 별도 [자동매매 현황] 창을 사용합니다. 상단 메뉴 [자동매매 → 자동매매 현황] 을 클릭하면 열립니다.

자동매매 현황(별도 창)

화면은 좌에서 우로 5개 영역이 나란히 배치되며, 왼쪽 항목을 선택하면 오른쪽이 연동되는 드릴다운 방식입니다.

영역내용
① 매매전략등록된 전략 목록(계좌번호·전략명). 하단에 기본 주문 금액·매수시간 A/B·매도시간 A/B·사용 여부·실행 여부·기타 설명 등 상세 표시
② 작업중 매매작업선택 전략의 작업 목록(계좌번호·종목코드·종목명·생성일시). [금일 완료작업 표시] 체크박스 제공, 우클릭으로 삭제. 하단에 작업 상세 표시
③ 매매작업 상세(명세)선택 작업의 명세 목록(준비·실행·주문구분·거래구분·주문금액·준비 조건·실행 조건·사용여부·사용중지이유·오류·오류 메세지·생성일시)
④ 주문 현황선택 명세의 주문 목록(종목·주문구분·거래구분·주문시간·주문/체결/미체결수량·주문가격·주문번호·처리상태)
⑤ 체결 현황선택 주문의 체결 내역(종목·주문구분·체결수량·체결가격·체결시간·체결번호)

우측 상단 [새로고침] 버튼으로 전체 데이터를 다시 불러오며, 각 영역 경계는 드래그하여 크기를 조절할 수 있습니다.

📌 참고: 이 창은 전체 계층을 넓게 훑어보기에 좋지만, 앞서 설명한 더블클릭 상세창(7.3)은 열리지 않습니다. 포지션·평가나 명세 2×2 카드를 보려면 메인 대시보드를 이용하십시오.

7.5 자동매매 주문 내역

과거의 주문과 체결 내역을 전략·기간별로 조회하려면 상단 메뉴 [자동매매 → 자동매매 주문 내역] 을 클릭합니다.

자동매매 주문 내역(별도 창)

조회 방법

  1. 상단에서 전략을 선택합니다.
  2. 기간을 지정합니다. 1일 · 2일 · 1주일 · 1개월 · 1년 빠른 버튼을 쓰거나, 시작일과 종료일을 직접 골라도 됩니다.
  3. [조회] 버튼을 클릭합니다. 하단 상태바에 총 N건이 표시됩니다.

주요 컬럼

조회 결과에는 다음과 같은 항목이 표시됩니다(일부).

컬럼설명
그룹같은 매매작업(사이클)을 묶는 ID
생성일시 / 주문일자주문 발생·저장 일시
전략명 · 계좌번호주문이 속한 전략과 계좌
주문구분 · 상세구분매수/매도 및 세부 구분
종목코드 · 종목명매매 종목
실행조건식주문을 트리거한 실행 조건식 표시명
주문가격 · 주문수량주문 시 가격과 수량
체결수량 · 체결평균가 · 체결금액실제 체결 결과
주문번호 · 원주문번호키움 API 주문번호
전송결과 · 키움결과주문 전송 성공 여부와 키움 응답 메시지
주문이유주문이 발생한 이유

Excel 내보내기

조회된 결과는 목록에서 우클릭 → [Excel 내보내기] 로 엑셀 파일로 저장할 수 있습니다.

7.6 자동매매 수익률 조회

매매작업 단위로 수익률을 요약·집계해서 보려면 상단 메뉴 [자동매매 → 자동매매 수익률 조회] 를 클릭합니다. 창 제목은 자동매매 매매작업별 수익률 조회입니다.

자동매매 수익률 조회(별도 창)

조회 방법

계좌와 전략을 선택하고 기간(1일 · 2일 · 1주일 · 1개월 · 1년 또는 직접 지정)을 정한 뒤 [조회] 를 누르면, 상태바에 조회된 작업 수가 표시됩니다. 계좌 콤보의 기본값은 전체 계좌입니다.

기간은 어느 날짜를 기준으로 거르나 (v2.5.4)

작업 상태기간 기준
청산 완료 (매수 수량 = 매도 수량)청산일(마지막 매도 주문일)
미청산 (보유 중)첫 매수일

종전에는 모든 작업을 첫 매수일로 걸러, 기간을 걸쳐 보유한 포지션이 매매 통계(7.7) 와 서로 다른 기간에 잡혔습니다. 이제 성과가 확정된 날에 귀속시키는 매매 통계와 같은 기준입니다. 미청산 작업은 청산일이 없으므로 첫 매수일 기준을 유지합니다(실현손익에는 0으로 더해지므로 합계에는 영향이 없습니다).

미청산 종목 현재가 평가

미청산 종목 현재가 평가 체크박스를 켜면, 아직 매도하지 않은(진행 중인) 종목을 현재가로 전량 매도했다고 가정하여 평가손익을 함께 계산합니다.

  • 평가 결과는 평가손익 · 평가수익률 컬럼으로 실현손익과 별도로 표시되며, 합계도 따로 집계됩니다.
  • 실현손익은 실제 매도된 금액만 반영하므로, 보유 중인 물량까지 포함한 현재 성과를 보고 싶을 때 사용합니다.

⚠️ 주의: 평가손익은 현재가 기준의 가정치입니다. 실제로 매도할 때의 체결가·수수료·세금에 따라 결과가 달라집니다.

합계 요약 바

화면 상단에는 조회된 전체 작업의 합계가 요약됩니다.

지표설명
매입금액 합계매수에 들어간 총 금액
매도금액 합계매도로 회수한 총 금액
실현손익 합계매도금액 − 매입금액
수익률실현손익 기준 평균 수익률
실현손익(순) 합계수수료·세금을 반영한 실현손익
수익률(순)실현손익(순) 기준 평균 수익률
평가손익 · 평가수익률 합계미청산 종목 현재가 평가를 켰을 때 함께 표시

📌 참고: 지표 이름에 붙는 "순" 은 수수료와 세금을 반영한 뒤의 값이라는 뜻입니다. 실제 손에 남는 금액에 가까운 것은 "순" 지표입니다. 수수료는 매수·매도 약정금액에 각각 0.015%, 제세금은 매도금액의 0.15% 로 계산한 추정치입니다.

⚠️ 주의 (v2.5.4) — 실현손익(순)이 이전보다 작게 나올 수 있습니다. 종전에는 매도 수수료가 빠져 있어 실현손익(순)이 그만큼 크게 계산되었습니다. 이제 매도 쪽에도 수수료를 매기며, 미청산 종목의 현재가 평가분에도 같은 기준을 적용합니다. 같은 계좌·전략·기간이면 매매 통계(7.7)의 총 실현손익과 이 화면의 실현손익(순) 합계가 일치합니다.

작업별 목록과 상세 주문

합계 아래에는 매매작업별 요약 표가 있습니다(작업ID·전략명·종목명·매입금액·매도금액·실현손익·수익률·실현손익(순)·수익률(순)·첫 주문·마지막 주문). 작업을 선택하면 하단에 그 작업의 상세 주문 내역(주문일시·구분·체결수량·매입가·매도가·결과·메시지)이 표시됩니다.

작업별 요약 표는 우클릭 → [Excel 내보내기] 로 저장할 수 있습니다. 평가 컬럼을 켜 두었다면 내보내기에도 함께 반영됩니다.

7.7 매매 통계 / 성과 분석 (v2.3.6)

청산이 끝난 매매를 모아 실현손익, 승률, 평균 수익/손실, 최대 낙폭(MDD) 같은 성과 지표를 한 화면에 보여 줍니다. 메뉴 [자동매매 → 매매 통계 / 성과 분석] 을 선택하면 별도 창이 열립니다.

📌 참고: 집계 대상은 청산 완료된 포지션(매매작업의 매수 체결 수량 = 매도 체결 수량)뿐입니다. 보유 중인 포지션은 손익이 확정되지 않았으므로 빠집니다. 보유분까지 포함한 현재 성과는 자동매매 수익률 조회(7.6) 의 미청산 종목 현재가 평가로 확인하십시오.

조회 방법

항목설명
계좌특정 계좌만 봅니다. (기본 전체 계좌)
전략특정 매매전략만 봅니다. (기본 전체 전략)
기간오늘 / 최근 7일 / 최근 30일(기본) / 최근 90일 / 최근 1년 / 전체 / 직접 입력 중에서 고릅니다. 시작일·종료일은 직접 입력을 골랐을 때만 바꿀 수 있습니다.
[조회]조건에 맞는 청산 거래를 집계합니다.
[Excel 저장]요약·전략별·종목별·거래 내역을 하나의 Excel 파일로 저장합니다.

기간은 청산일(마지막 매도 주문일) 기준으로 거릅니다. 성과가 확정된 날에 귀속시키기 위해서입니다.

요약 지표

지표설명
청산 거래집계된 거래 수와 승·패 건수
승률이익으로 끝난 거래의 비율(%)과 최대 연속 승·패
총 실현손익 (추정)수수료·제세금을 뺀 실현손익 합계와 거래당 평균
투입금액 대비 수익률 (추정)총 실현손익 ÷ 총 매입금액, 거래별 평균 수익률
평균 수익 / 평균 손실이익 거래의 평균 이익과 손실 거래의 평균 손실(원)
손익비 (Profit Factor)총이익 ÷ 총손실. 1보다 크면 이익 우위입니다. 손실 거래가 없으면 ∞ 로 표시됩니다.
최대 낙폭 (MDD)청산 순서대로 누적한 실현손익이 고점에서 가장 크게 떨어진 금액
최대 수익 / 최대 손실한 거래의 가장 큰 이익과 가장 큰 손실

⚠️ 주의: 실현손익은 체결가 기준 금액에서 수수료(매수·매도 각 0.015%) 와 제세금(매도 0.15%) 을 뺀 추정치입니다. 실제 증권사 정산 금액과는 수수료 등급·세율 변동에 따라 차이가 날 수 있습니다.

전략별 · 종목별 · 거래 내역 탭

탭내용
전략별전략마다 거래수 · 승/패 · 승률 · 총 손익 · 평균 손익 · 매입금액 · 수익률 · 평균 수익률
종목별같은 항목을 종목 단위로 집계
거래 내역청산 거래 한 건씩 — 청산일시 · 진입일시 · 보유일 · 전략 · 종목 · 수량 · 평균매수가 · 평균매도가 · 매입금액 · 매도금액 · 수수료+세금 · 실현손익 · 수익률 · 계좌

💡 팁: 같은 계좌·전략·기간으로 조회하면 이 화면의 총 실현손익과 자동매매 수익률 조회(7.6) 의 실현손익(순) 합계가 같은 값이 됩니다(v2.5.4). 두 화면의 숫자가 다르면 조회 조건을 먼저 확인하십시오.

7.8 매매제한 현황

자동매매는 키움 REST API와 프로그램 자체의 여러 제한 안에서 동작합니다. 각 계좌가 현재 어느 한도를 얼마나 쓰고 있는지 게이지로 실시간 확인하려면, 상단 메뉴 우측의 [매매제한 현황] 을 클릭해 별도 창을 엽니다.

매매제한 현황(별도 창)

창에는 계좌별 카드가 배치되며, 각 카드에 다음 6종 제한 항목이 게이지로 표시됩니다. 사용량이 한도에 가까워지면 게이지 색이 붉게 변합니다.

제한 항목의미
총 매수금액 제한사용한 매수금액 / 최대 매수금액 한도(원)
실시간 주식 체결 데이터 요청 제한구독 중인 종목 수 / 최대(REST API 제한). 구독 종목 수는 매매작업 개수(중복 종목 제외) 기준. [종목보기] 버튼으로 요청 종목 목록(코드·종목명)을 볼 수 있음
조건검색식 요청 제한실시간 조건검색식 개수 / 최대(REST API 제한)
일일 동일 종목 매매작업 생성 제한하루에 같은 종목으로 만들 수 있는 매매작업 최대 횟수. 초과한 종목은 코드·횟수로 표시되며(초과 없으면 "제한 초과 종목 없음"), 자정에 초기화
연속 동일 매수주문 제한같은 종목에 대한 연속 동일 매수주문 최대 횟수. 다른 주문이 발생하면 초기화
보유 종목수 제한 (전략별)전략별 보유 종목 수 / 최대. 한도에 도달하면 해당 전략의 신규 매수가 제한됨

각 항목 옆의 ? 도움말을 누르면 그 제한이 무엇을 뜻하는지 요약 설명을 볼 수 있습니다. 초과된 종목은 강조 색으로 표시됩니다.

💡 팁: 7.1.1에서 전략을 켤 때 검증하는 실시간 체결 등록 한도와 조건검색식 등록 한도가 바로 이 창의 2·3번 항목입니다. 전략이 켜지지 않거나 새 매매작업이 만들어지지 않을 때, 이 창에서 어떤 한도가 가득 찼는지 먼저 확인하면 원인을 빠르게 찾을 수 있습니다.

7.9 권리이벤트 감지와 매매작업 자동 사용중지

액면분할·병합, 무상·유상증자, 배당락 같은 권리 이벤트가 발생하면 그날의 기준가가 전일종가와 달라집니다. 이때 매매작업이 들고 있는 평균단가·목표가는 변경 전 가격 기준으로 남아 있어, 그대로 두면 잘못된 기준으로 매도·손절이 실행될 수 있습니다. 프로그램은 전일종가와 기준가를 비교해 이를 감지합니다.

7.9.1 검사 시점

  • 프로그램 시작 시 1회 비교합니다.
  • 이후 매일 종목정보 캐시 새로고침 시각(기본 07:40)에 종목 캐시를 갱신한 뒤 다시 비교합니다.
  • 종목 캐시가 정상적으로 갱신되지 않았으면 비교를 건너뜁니다. 잘못된 데이터로 매매작업을 멈추지 않기 위해서입니다.

7.9.2 경고 표시 (소폭 조정)

괴리가 크지 않으면(배당락 등) 진행 중 매매작업 목록의 종목명 옆에 ⚠ 경고 아이콘만 표시하고 매매는 그대로 진행합니다. 아이콘에 마우스를 올리면 전일종가·기준가·괴리율을 확인할 수 있습니다.

이 경고는 프로그램을 다시 시작해도 유지됩니다. 권리락 다음 날부터는 전일종가와 기준가가 다시 일치하지만, 왜 그 종목이 주의 대상인지 알 수 있도록 표시를 남깁니다.

7.9.3 매매작업 자동 사용중지 (대폭 조정)

괴리율이 자동매매 중지 괴리율(기본 30%) 이상이면 해당 종목의 실행 중인 매매작업을 자동으로 사용중지합니다. 30%는 하루 가격제한폭을 넘는 수치로, 정상적인 시세 변동으로는 나올 수 없는 값이기 때문입니다.

  • 매수·매도·손절이 모두 중단됩니다.
  • 사용중지 사실은 로그판과 트레이 알림으로 통보됩니다.
  • 대시보드에서 직접 사용중지한 것과 동일하게, 목록에서 미사용 상태로 표시됩니다.

⚠️ 주의: 자동 사용중지된 작업은 [사용] 버튼으로 재개할 수 없습니다. 권리이벤트 이후에는 보유 포지션의 수량·평균단가가 실제와 달라, 그대로 재개하면 잘못된 목표가로 매도되거나 잔여 수량이 방치되는 등 의도치 않은 매매가 발생합니다. [사용] 을 시도하면 재개를 거부하고 안내 창이 표시됩니다.

정리 방법: 보유 포지션을 수동으로 정리한 뒤(간편 매매 또는 일괄매도), 해당 매매작업을 삭제하고 새로 생성하십시오. 새로 만든 작업은 변경된 가격 기준으로 다시 시작합니다.

7.10 애프터마켓(16:00~20:00) 매매 (v2.5.0)

2026년 9월 14일(월)부터 한국거래소에 애프터마켓(16:00~20:00) 이 새로 열리고, 시간외단일가 시장은 폐지되었습니다. 부엉이 트레이더 프로도 v2.5.0부터 이에 맞추어 매매 시간과 주문 방식을 조정했습니다. 이 절에 시간표와 주의사항을 모았습니다.

7.10.1 시간대별 주문 경로

실서버 계좌는 시간대에 따라 다음 거래소로 주문을 보냅니다.

시간시장부엉이 트레이더 프로 동작
08:00 ~ 08:50프리마켓 (NXT 단독)NXT로 주문
09:00 ~ 15:20정규장최선집행(SOR)으로 주문
15:20 ~ 15:40종가 단일가 등자동매매 주문을 내지 않음
15:40 ~ 16:00NXT 애프터마켓 (NXT 단독)NXT로 주문
16:00 ~ 20:00애프터마켓 (KRX + NXT)최선집행(SOR)으로 주문

📌 참고: NXT에서 거래되지 않는 KRX 전용 종목은 09:00~20:00 에 거래할 수 있습니다(종전 18:00까지).

⚠️ 주의 — 모의투자 계좌: 모의투자는 통합시세를 지원하지 않아 항상 KRX로 주문하며, 모의투자 서버 사양상 09:00~15:30 에만 매매합니다. 애프터마켓 동작은 실서버 계좌에서만 확인할 수 있습니다.

7.10.2 20:00 기준으로 바뀐 동작

종전에 15:30 또는 18:00 에 멈추던 동작들이 20:00 기준으로 바뀌었습니다.

동작바뀐 내용참고
대시보드 일괄매도 · 추가매수15:30 → 20:00 까지. 애프터마켓 시간에는 확인 창 표시7.2.2
포착 조건검색 지정 시각09:0015:30 → **08:0020:00** (v2.5.5)5.7.4
외부신호 — KRX 전용 종목 시간대09:0018:00 → **09:0020:00**13.4.7
자동 시작 스케줄러 종료 기본값20:10 (새로 설치한 경우)10.3
AI 미처리 기각 요약 알림15:40 → 20:056.9

⚠️ 주의 — 기존 사용자는 스케줄러 종료 시각을 직접 바꾸어야 합니다. 이미 저장해 둔 종료 시각(예: 18:00)은 그대로 유지됩니다. 20:00 이전에 프로그램이 스스로 종료되면 애프터마켓 도중에 매매가 멈추고 미체결 주문이 남을 수 있습니다. [설정 → 자동시작 스케줄러] 에서 종료 시간을 20:10 으로 바꾸어 저장하십시오(10장).

7.10.3 정규장 미체결 주문 처리

애프터마켓은 정규장 미체결 주문을 이어받지 않습니다. 그래서 프로그램은 정규장이 끝난 뒤 미체결 주문을 다음과 같이 처리합니다.

시각처리대상
15:30 무렵정규장 미체결 주문을 취소합니다. 다시 주문하지 않습니다.자동매매 주문 전체 (기본 동작)
16:00미체결 매도를 취소한 뒤 애프터마켓 현재가 기준으로 재주문합니다.미체결 매도를 애프터마켓으로 이전을 켠 주문전략의 매도 주문만 (5.7.3)

📌 참고: 미체결을 남겨 두면 매수 주문가능금액이 묶여 애프터마켓에서 새 주문을 내지 못하기 때문에 취소합니다. 처리 대상은 이 프로그램이 낸 주문뿐이며, 사용자가 영웅문 등 다른 매체에서 직접 낸 주문은 건드리지 않습니다.

7.10.4 애프터마켓에서 거래할 수 없는 종목

거래소 규정상 애프터마켓에서는 시장관리 종목을 뺀 유가증권·코스닥 종목만 거래되며, ETF·ETN 은 제외됩니다. 프로그램은 거래소가 어차피 거부할 주문을 반복해서 내지 않도록 아래 종목을 16:00~20:00 에 주문 전에 걸러냅니다.

  • 거래 불가가 확인된 시장 — ETF, ELW, K-OTC, 코넥스
  • 시장관리 종목 — ETF주의, 정리매매, 단기과열, 투자위험, 투자경고로 지정된 종목
경로걸러졌을 때
자동매매주문을 내지 않고 종목당 한 번 로그를 남깁니다.
대시보드 추가매수 · 간편 매매안내 창을 띄우고 주문을 막습니다.

📌 참고 (v2.5.1): v2.5.0에서는 "코스피·코스닥으로 분류된 종목만" 거래 가능으로 판정해, 리츠·뮤추얼펀드처럼 유가증권시장에 상장돼 있지만 세부 분류가 따로 있는 종목까지 막혔습니다. v2.5.1부터는 위 목록에 해당하는 종목만 막고, 분류를 알 수 없는 종목은 막지 않습니다. 리츠 종목을 자동매매에 넣어 두셨다면 v2.5.0을 쓰던 기간의 애프터마켓에는 주문이 나가지 않았으니 매매작업 상태를 한 번 확인하십시오.

📌 참고 (v2.5.1): 이 종목 제한은 16:00 이후에만 적용됩니다. 15:40~16:00 은 넥스트레이드(NXT) 단독 시간이고 NXT의 종목 기준은 KRX와 다르므로, 이 구간에는 NXT에서 거래되는 ETF 등을 주문할 수 있습니다.

7.10.5 애프터마켓에서 낼 수 없는 주문유형

애프터마켓(16:00~20:00)은 지정가 · 최우선지정가 · 최유리지정가만 받습니다. 시장가, 조건부지정가처럼 가격이 시장에 연동되는 주문은 받지 않습니다.

경로동작
자동매매 엔진 (주문전략 · 대시보드 일괄매도 · 추가매수)시장가 주문을 지정가(매수는 상한가, 매도는 하한가) 로 바꾸어 냅니다.
간편 매매(8장)지원하지 않는 주문 종류를 고르면 주문이 거절되고 사유가 표시됩니다.

📌 참고: 15:40~16:00(NXT 단독)에는 이 주문유형 제한을 적용하지 않습니다.

⚠️ 주의: 애프터마켓은 정규장보다 호가가 얇습니다. 시장가를 상·하한가 지정가로 바꾸어 내므로 체결 가격이 불리하거나 아예 체결되지 않을 수 있습니다. 애프터마켓까지 매매하는 전략은 모의투자로 확인할 수 없으니(7.10.1), 적은 금액으로 먼저 동작을 확인하십시오.

7.10.6 업데이트 후 체크리스트

순서확인할 것확인하지 않으면
1자동 시작 스케줄러의 종료 시각을 20:10 으로 변경 (기존 사용자)애프터마켓 도중 프로그램이 종료됨
2주문유형이 시간외단일가(폐지) 로 표시되는 전략을 다른 유형으로 변경 (5.7.1)해당 전략의 주문이 실패함
3정규장 미체결 매도를 애프터마켓까지 가져가려면 주문전략에서 미체결 매도를 애프터마켓으로 이전 체크 (5.7.3)미체결은 15:30 무렵 취소만 됨