Chapter 8 / 11
8. 권리이벤트 감지와 자동매매 중지
액면분할·병합, 무상·유상증자, 배당락 같은 권리이벤트가 발생하면 기준가가 전일종가와 달라집니다. 이때 보유 포지션의 평균단가·최고가는 변경 전 가격 기준으로 남아 있어, 손절·익절·트레일링 스탑이 잘못된 기준으로 오발동할 수 있습니다. 프로그램은 이를 감지해 경고하거나 해당 종목의 자동매매를 중지합니다.
8.1 감지 시점
- 프로그램 시작 시(보유 종목 시세 구독 이후) 1회 비교합니다.
- 이후 매일 종목정보 캐시 새로고침 시각(기본 07:40, 시스템 설정에서 변경)에 캐시를 갱신하고 다시 비교합니다.
- 활성 전략의 감시 대상 종목만 검사하며, 추가 API 요청 없이 기존 조회 데이터를 재사용합니다.
8.2 경고 표시 (소폭 조정)
괴리율이 임계값 미만이면 감시 화면 종목명 옆에 ⚠ 아이콘만 표시하고 자동매매는 그대로 진행합니다. 툴팁에서 전일종가·기준가·괴리율을 확인할 수 있습니다.
8.3 자동매매 중지 (대폭 조정)
괴리율이 자동매매 중지 괴리율(기본 30%, 시스템 설정에서 변경) 이상이면 해당 종목의 자동매매를 중지하고 🔴 매매중지 배지를 표시합니다. 중지는 종목 단위로 적용되며 계좌를 가리지 않습니다.
| 구분 | 내용 |
|---|---|
| 차단되는 동작 | 손절·익절·트레일링 스탑·분할 매매, 당일 청산, 조건검색식에 의한 신규 진입·매수·매도 |
| 유지되는 동작 | 실시간 시세 수신(현재가·평가손익 확인), 사용자의 수동 매도 |
| 알림 | 최초 중지 시 팝업·로그·텔레그램 알림을 발행합니다. (매일 재판정으로 중복 알림되지 않습니다) |
📌 참고: 괴리율을 0으로 입력하면 중지하지 않고 ⚠ 경고만 표시합니다.
8.4 중지된 종목 정리
- 중지 상태는 저장되어 프로그램을 재시작해도 유지됩니다. 재시작 시 중지 종목을 묶은 요약 안내가 1회 표시됩니다.
- 권리락 다음 날부터는 전일종가와 기준가가 다시 일치하지만, 중지 종목의 ⚠ 경고와 사유 툴팁은 그대로 유지됩니다.
- 보유 수량은 그대로 남아 있습니다. 정리는 보유종목 일괄 매도(9.3) 또는 감시 화면의 수동 매도로 진행하십시오.
⚠️ 권리이벤트로 중지된 종목은 자동매매를 재개할 수 없습니다. 분할·병합 이후 평균단가가 변경 전 기준으로 남아 있어, 재개하는 순간 잘못된 기준으로 손절·익절이 즉시 발동하기 때문입니다. 컨텍스트 메뉴의 "선택 종목 자동매매 재개"를 실행하면 사유와 대안을 안내하는 창이 표시됩니다.
📌 참고: 같은 매매중지 배지라도 사용자가 직접 멈춘 🟠 일시중지(4.3.4)는 언제든 재개할 수 있습니다. 색과 문구로 구분됩니다.
