9. 운영 도구

설정 메뉴에서 다음 도구에 진입합니다.

9.1 시스템 설정

시스템 설정 창은 표시 · 매매 · 손익 계산 · 안전장치 · 데이터·진단 5개 탭으로 구성됩니다.

9.1.1 표시

9.1.2 매매

예전에 매매 설정 프로필의 "기타 설정" 탭에 있던 항목들이 이곳으로 옮겨졌습니다. 프로필마다 따로 두지 않고 모든 전략에 함께 적용됩니다.

💡 왜 옮겼나: 프로필마다 다르게 두면 같은 장에서 어떤 종목은 청산되고 어떤 종목은 남는 이유를 되짚을 수 없습니다. 당일 청산이나 재매수 제한은 특정 전략이 아니라 그날의 운용 방침에 가까운 항목이라 한곳에서 정하도록 했습니다.

⚠️ 공통 값은 기본값(모두 꺼짐)으로 시작합니다. 프로필마다 값이 달랐을 수 있어 무엇을 공통값으로 삼을지 정할 방법이 없었기 때문입니다. 이 기능들을 쓰고 계셨다면 이곳에서 다시 지정해 주십시오. 업데이트 후 첫 실행 때 안내 창이 한 번 뜹니다. (프로필에 저장돼 있던 기존 값은 지우지 않고 보관하지만 매매에는 쓰이지 않습니다.)

애프터마켓까지 기다렸다 청산 (v1.7.0) — 2026년 9월 14일부터 KRX에도 애프터마켓(16:00~20:00)이 열려, 정규장이 끝난 뒤에도 대부분의 종목을 팔 수 있습니다(11.4). 예전 이름은 "NXT 거래 가능 종목은 따로 청산" 이었고 NXT 종목에만 적용됐지만, 이제는 전 종목이 대상이고 NXT 거래 여부는 언제부터 팔 수 있는지만 가릅니다.

• 애프터마켓 시점은 16:00~19:50 사이를 권장합니다. 16:00 이전으로 정하면 NXT에서 거래되지 않는 종목은 16:00까지 자동으로 미뤄집니다. 세션 막판에는 유동성이 얕아 체결이 어려울 수 있습니다.
• ETF는 설정한 정규장 시점이 이미 정규장 밖(15:30 이후)이면 15:20으로 앞당겨 팔 수 있을 때 팝니다. 종전에는 16:00 이후로 미뤄졌다가 매도가 거부되어 오류 상태로 멈췄습니다.
• 감시 목록의 [청산 예정] 열에는 설정한 시각이 아니라 실제로 팔리는 시각이 표시되고, 다른 이유는 마우스를 올리면 나옵니다(4.3).
• 옵션을 켜지 않으면 모든 종목이 정규장 시점에 청산됩니다.

⚠️ 켜 두셨던 분은 대상이 넓어졌습니다. 지금까지 정규장 시점에 팔리던 KRX 전용 종목도 이제 애프터마켓까지 넘어갑니다. 설정값(켬/끔·시각·주문 종류·호가 조정)은 그대로이니, 바뀐 대상 범위만 확인하십시오.

📌 참고: ETN은 아직 가려내지 못합니다. 전종목 정보를 코스피·코스닥·ETF 세 종류로 받고 있어 ETN은 일반 종목처럼 미뤄집니다. KRX에서만 거래되는 ETN을 들고 있다면 청산 시점을 확인하십시오.

당일 청산은 산 날 안에만 적용됩니다 (v1.7.0). 날짜가 바뀐 보유분은 대상에서 빠지고 감시 목록에 이월 로 표시됩니다. 종전에는 며칠 만에 프로그램을 켜면 전날 이전에 산 물량에 청산 주문이 나가 거부되고, 그 종목이 오류 상태로 멈췄습니다. 주문을 낼 수 없는 시각이면 주문을 내지 않고 로그에 남깁니다.

📌 참고: 이 항목들은 전략을 가동한 상태에서도 변경할 수 있고 저장 즉시 반영됩니다. 다만 당일 청산을 켜거나 시각을 바꿀 때, 재매수 제한을 끌 때는 바로 주문이 나갈 수 있어 확인을 한 번 받습니다. 이 프로그램이 관리하지 않는 주문(HTS 등)은 자동 취소 대상이 아닙니다.

9.1.3 손익 계산

평가손익·실현손익·매매 통계를 "지금 팔면 실제로 손에 남는 금액" 기준으로 표시합니다.

⚠️ 표시되는 손익에만 영향을 줍니다. 손절·익절·트레일링 등 주문 발동 조건은 종전대로 체결가 기준으로 판단하며 이 설정의 영향을 받지 않습니다.

• 요율은 증권사·계좌마다 다르므로 실제 적용 요율을 입력하십시오. 0을 입력하면 해당 항목을 반영하지 않습니다.
• 프리마켓(08:0008:50)·애프터마켓 1부(15:4016:00) 주문은 NXT로만 나가므로 NXT 요율이 적용됩니다. 정규장과 애프터마켓 2부(16:00~20:00)는 통합(SOR) 주문이라 어느 거래소에서 체결됐는지 알 수 없어 KRX 요율로 계산합니다.
• ETF는 제세금 면제로 계산이 기본 켜짐입니다. 끄면 실제보다 손익이 낮게 표시됩니다.

⚠️ 제세금 기본값이 0.20% 입니다. 2026년 1월 1일부터 매도 시 세금이 코스피·코스닥 모두 합계 0.20% 로 인상되었습니다(코스피: 증권거래세 0.05% + 농어촌특별세 0.15% / 코스닥: 증권거래세 0.20%). 종전 기본값 0.15%를 그대로 쓰고 계셨다면 자동으로 0.20%가 됩니다. 직접 다른 값을 넣어 두셨다면 그 값은 유지됩니다. 항목 이름도 "증권거래세율"에서 "제세금률" 로 바뀌었습니다.

📌 참고: 증권사는 주문 한 건마다 수수료·세금의 원 미만을 잘라 청구합니다. 이제 주문 건별로 계산해 합산하므로 실제 청구액과의 차이가 줄었습니다. 분할 매수·매도가 많을수록 차이가 컸던 부분입니다.

9.1.4 안전장치

한도 도달 시 해당 주문이 차단되고 텔레그램 알림이 발송됩니다.

일일 매수/매도 한도, 종목별 매수 한도, 1회 주문 최대 금액, 일일 매수 금액 한도, 잔고 최대 종목수 제한은 계좌별 설정입니다. 계좌 AppKey 설정 창에서 지정하십시오. (2.3 참조)

⚠️ 반복 주문 한도를 너무 낮게 잡지 마십시오. 분할 매도처럼 정상적인 연속 주문이 한도에 걸리면 해당 포지션이 오류 상태로 남을 수 있습니다.

9.1.5 데이터·진단

📌 참고: 계좌현황의 평가손익·총자산 표시 자체는 동기화 주기와 무관하게 3초마다 갱신됩니다. 주기를 짧게 잡을수록 키움 API 호출이 비례해 늘어나므로 요청 한도에 유의하십시오.

⚠️ 실시간 조건 판단 로그는 종목당 초당 수십~수백 건이 기록될 수 있어 진단 목적으로만 권장합니다.

9.2 매매 통계 · 성과 분석

계좌·전략·기간으로 필터하여 청산 거래 수·승률·총 실현손익(추정)·평균 수익/손실·손익비(Profit Factor)·MDD·최대 수익/손실을 카드로 보여줍니다. 전략별 · 종목별 · 거래 내역 세 탭을 제공합니다.

거래 내역에는 청산 시각·종목·전략·매수/매도 금액·실현손익·수익률·보유기간이 표시됩니다.

⚠️ 집계 기준이 달라졌습니다 (v1.5.5). 종전에는 판 수량만큼 산 기록이 없는 거래도 집계에 들어갔습니다. 대표적으로 자동매매 편입 종목처럼 앱 밖에서 사 온 수량이 섞이면, 그 매도 대금이 통째로 이익으로 잡혀 수익률이 실제보다 크게 부풀었습니다.

이제 판 수량만큼 산 기록이 있는 거래만 집계합니다. 그래서 업데이트 후 누적 실현손익과 거래 건수가 이전보다 줄어들어 보일 수 있습니다. 값이 잘못 계산되던 것을 바로잡은 것이며, 실제로 사고판 결과가 달라진 것은 아닙니다.

반대로 매수 기록 일부가 유실된 과거 거래도 함께 빠집니다. 프로그램이 꺼져 있는 동안 HTS에서 사고 앱으로 판 종목 등이 이에 해당합니다.

📌 참고 (v1.5.9): 외부보유에서 자동매매로 편입한 종목의 거래도 이제 집계됩니다. 편입할 때의 수량·취득원가(증권사 매입단가)를 기록해 매수 쪽에 더합니다. 편입분의 매수 수수료는 실제 청구액을 알 수 없어 KRX 요율로 추정합니다. 이 기능 이전에 편입한 포지션은 당시 매입단가를 복원할 수 없어 종전대로 집계에서 빠집니다.

📌 참고: 조회에 실패하면 직전 결과가 그대로 남아 방금 고른 기간의 결과로 오해할 수 있었습니다. 이제 실패 사실을 화면에 표시합니다.

9.3 보유종목 일괄 매도

주문 종류·가격 구분·호가 조정을 지정하고, 종목을 미리 보고 선택해 한 번에 매도합니다.

9.4 프로그램 실행 스케줄

자동 실행 시작/종료 시간과 요일을 지정합니다(07:30~23:00 범위). Windows 작업 스케줄러를 사용하므로 등록 시 관리자 권한이 필요하며, 종료 시각에는 프로그램이 스스로 정상 종료합니다.

⚠️ 애프터마켓(~20:00)에 매매하거나 당일 청산을 애프터마켓 시점으로 두었다면 종료 시각을 20:00 이후로 잡으십시오. 그 전에 프로그램이 꺼지면 청산 주문이 나가지 않고 미체결 주문이 남을 수 있습니다.

9.5 설정 내보내기 / 가져오기

전략·프로필 등의 설정을 파일로 내보내고 가져올 수 있습니다.

📌 참고: 예전 버전에서 내보낸 파일을 가져와도 이 PC의 하이브리드 모드 선택은 그대로 유지됩니다(4.3.1). 종전에는 그 값이 뒤집히거나 다음 실행에서 되살아나는 문제가 있었습니다.

⚠️ 텔레그램 봇 토큰은 파일에 저장되지 않습니다. 토큰만 알면 누구나 해당 채널에 글을 쓸 수 있어 내보내기에서 제외합니다. 다른 PC에서 가져오신 뒤 다시 입력해 주십시오. (10장)

9.6 로그 파일 관리자

로그 보관 기간을 설정하고, 파일 목록(크기·수정일)을 확인하거나 메모장으로 열고 삭제할 수 있습니다. 문제 진단이 필요할 때 로그 파일을 서버로 전송할 수 있습니다.

라이트 버전은 매매·시세용 외부 서버와 연동하지 않으며, 이 기능은 진단 목적의 로그 업로드에 한정됩니다.

9.7 키움 접속이 막혔을 때 (IP 변경)

키움은 미리 등록한 인터넷 IP에서만 접속을 허용합니다. 그런데 가정집 인터넷은 IP가 수시로 바뀝니다. 공유기를 껐다 켰거나 통신사가 IP를 새로 배정하면 어제까지 되던 접속이 갑자기 막힐 수 있습니다.

접속이 거부되면 화면 상단에 빨간 경고 줄이 나타나고, 누르면 안내 창이 열립니다.

두 값이 다르면 IP가 바뀐 것이 원인입니다. 새 IP를 키움 홈페이지에 등록한 뒤 [다시 연결] 을 누르면 됩니다.

• 텔레그램 알림도 함께 발송됩니다. 자동 시작으로 무인 운영 중이더라도 폰으로 알 수 있습니다.
• 인터넷 자체가 끊긴 경우에는 IP 안내 대신 인터넷 확인을 안내합니다.
• 프로그램이 30분마다 IP 변경을 미리 확인합니다. ([시스템 설정 → 표시]의 접속 IP 변경 감시, 기본 켜짐)

📌 참고: 감시를 꺼도 실제로 접속이 거부됐을 때의 안내는 그대로 동작합니다. IP 확인에는 외부 조회 서비스를 사용합니다.