Chapter 8 / 11

8. 권리이벤트 감지와 자동매매 중지

액면분할·병합, 무상·유상증자, 배당락 같은 권리이벤트가 발생하면 기준가가 전일종가와 달라집니다. 이때 보유 포지션의 평균단가·최고가는 변경 전 가격 기준으로 남아 있어, 손절·익절·트레일링 스탑이 잘못된 기준으로 오발동할 수 있습니다. 프로그램은 이를 감지해 경고하거나 해당 종목의 자동매매를 중지합니다.

8.1 감지 시점

  • 프로그램 시작 시(보유 종목 시세 구독 이후) 1회 비교합니다.
  • 이후 매일 종목정보 캐시 새로고침 시각(기본 07:40, 시스템 설정에서 변경)에 캐시를 갱신하고 다시 비교합니다.
  • 활성 전략의 감시 대상 종목만 검사하며, 추가 API 요청 없이 기존 조회 데이터를 재사용합니다.

8.2 경고 표시 (소폭 조정)

괴리율이 임계값 미만이면 감시 화면 종목명 옆에 ⚠ 아이콘만 표시하고 자동매매는 그대로 진행합니다. 툴팁에서 전일종가·기준가·괴리율을 확인할 수 있습니다.

8.3 자동매매 중지 (대폭 조정)

괴리율이 자동매매 중지 괴리율(기본 30%, 시스템 설정에서 변경) 이상이면 해당 종목의 자동매매를 중지하고 🔴 매매중지 배지를 표시합니다. 중지는 종목 단위로 적용되며 계좌를 가리지 않습니다.

구분내용
차단되는 동작손절·익절·트레일링 스탑·분할 매매, 당일 청산, 조건검색식에 의한 신규 진입·매수·매도
유지되는 동작실시간 시세 수신(현재가·평가손익 확인), 사용자의 수동 매도
알림최초 중지 시 팝업·로그·텔레그램 알림을 발행합니다. (매일 재판정으로 중복 알림되지 않습니다)

📌 참고: 괴리율을 0으로 입력하면 중지하지 않고 ⚠ 경고만 표시합니다.

8.4 중지된 종목 정리

  • 중지 상태는 저장되어 프로그램을 재시작해도 유지됩니다. 재시작 시 중지 종목을 묶은 요약 안내가 1회 표시됩니다.
  • 권리락 다음 날부터는 전일종가와 기준가가 다시 일치하지만, 중지 종목의 ⚠ 경고와 사유 툴팁은 그대로 유지됩니다.
  • 보유 수량은 그대로 남아 있습니다. 정리는 보유종목 일괄 매도(9.3) 또는 감시 화면의 수동 매도로 진행하십시오.

⚠️ 권리이벤트로 중지된 종목은 자동매매를 재개할 수 없습니다. 분할·병합 이후 평균단가가 변경 전 기준으로 남아 있어, 재개하는 순간 잘못된 기준으로 손절·익절이 즉시 발동하기 때문입니다. 컨텍스트 메뉴의 "선택 종목 자동매매 재개"를 실행하면 사유와 대안을 안내하는 창이 표시됩니다.

📌 참고: 같은 매매중지 배지라도 사용자가 직접 멈춘 🟠 일시중지(4.3.4)는 언제든 재개할 수 있습니다. 색과 문구로 구분됩니다.