4. 메인 화면 둘러보기

메인 화면은 상단 메뉴바, 3열 본문, 하단 로그·상태바로 구성됩니다.

📌 참고: 좌측(계좌현황·매매 전략 목록)과 우측(실시간 체결 현황) 패널은 접을 수 있습니다. 접으면 그 자리에 세로 막대가 남고, 막대를 누르면 다시 펼쳐집니다(≪ ≫ 버튼). 실시간 체결 현황은 기본 접힘이라 보유 종목 목록이 더 넓게 보입니다.

4.1 계좌현황 패널 (좌측)

총자산(추정 예탁)·주문가능금액·총매입·총평가·총평가손익·계좌 수익률을 보여줍니다. 새로고침 버튼과 API 키 설정 진입 버튼이 있습니다.

계좌번호 마스킹 — 화면에 표시되는 계좌번호는 가운데가 가려진 형태(81****95)로 나옵니다. 방송·화면 공유 시 노출을 막기 위한 것으로 기본 켜짐이며, 시스템 설정에서 끌 수 있습니다. 주문·조회 등 내부 동작은 항상 원본 계좌번호를 사용합니다.

한도 경고 — 예전에 늘 붙어 있던 "당일 주문" 줄은 없어졌습니다. 대신 일일 주문 한도의 80% 이상을 사용했을 때만 주황색 경고가 나타납니다. 경고가 보이면 곧 주문이 자동 거부될 수 있다는 뜻입니다. 잔고 종목 수가 상한의 80%를 넘을 때도 같은 자리에 경고가 나타납니다. (한도 조정은 2.3)

4.2 매매 전략 목록 패널 (좌측)

등록한 전략이 카드로 표시됩니다. 카드의 가동/정지 토글로 개별 전략을 켜고 끌 수 있고, 일괄 실행 / 일괄 중지 버튼과 신규 전략 등록 버튼을 제공합니다. 카드에는 적용 계좌가 함께 표시됩니다.

📌 참고: 전략 이름은 기본으로 숨겨져 있습니다. 조건식·설정 프로필·계좌만으로도 전략을 구분할 수 있기 때문이며, 카드에 마우스를 올리면 툴팁으로 표시됩니다. 항상 보이게 하려면 [시스템 설정 → 표시]에서 켜십시오.

4.3 실시간 보유 종목 감시 (중앙)

보유 종목의 종목명·평균단가·현재가·수익률·평가손익·분할 진행 단계·상태를 실시간으로 보여줍니다. 자주 보는 정보(상태 → 전략 → 종목명 → 평가손익 → 수익률)가 왼쪽에 오도록 배치되어 있습니다.

[청산 예정] 열 — 그 종목이 실제로 몇 시에 팔릴 예정인지 보여 줍니다. 청산 대상이 아니면 — 로 표시하고, 매매 설정에서 공통과 다르게 지정한 종목은 주황색으로 구분됩니다(6.2). 같은 화면에서 왜 어떤 종목만 남는지 바로 알 수 있습니다. 칸에 마우스를 올리면 그 시각이 공통 설정에서 왔는지, 매매 설정에서 지정한 것인지 알려 줍니다.

계좌가 여러 개라면 계좌 필터로 특정 계좌의 종목만 볼 수 있습니다.

열 제목으로 정렬 — 모든 열(맨 앞 선택 체크박스 제외)의 제목을 누르면 정렬되고, 한 번 더 누르면 역순이 됩니다. 순서는 화면에 보이는 대로입니다.

📌 참고: 정렬은 누른 그 순간의 순서입니다. 시세가 움직여도 행이 저절로 자리를 바꾸지 않습니다. 손익 순으로 정렬한 행이 매 순간 오르내리면 클릭조차 어렵기 때문입니다.

청산 예정 시각이 설정과 다를 때 — 애프터마켓까지 미뤄진 종목(9.1.2)이나 정규장 시각으로 앞당겨진 ETF처럼 설정값과 실제 청산 시각이 다르면, 칸에 마우스를 올려 왜 달라졌는지 확인할 수 있습니다. 전날 이전에 산 물량은 당일 청산 대상이 아니라서 이월 로 표시됩니다.

흐리게 보이는 현재가 — 아직 실제 시세를 받지 못해 매입단가 등 대체값으로 표시 중인 종목은 현재가·평가금액·평가손익·수익률이 흐리게 표시되고 아이콘과 툴팁으로 알려 줍니다. 전략이 중지된 종목도 시세는 계속 받으므로 장 마감 후 현재가가 매입단가에 고정되지 않습니다.

4.3.1 외부에서 매수한 종목 — "외부보유"

HTS 등 이 프로그램 밖에서 매수한 종목은 감시 목록에 "외부보유" 로 표시만 되고, 자동매매 대상이 되지 않습니다.

⚠️ 예전에는 자동으로 편입되었습니다. 장기 보유 목적으로 산 종목이 손절선에 걸려 바로 팔릴 수 있는 위험이 있어 바뀌었습니다.

자동매매에 넣으려면 종목을 선택하고 우클릭 → [선택 종목 자동매매 편입] 을 실행합니다.

• 편입할 때 어느 전략으로 관리할지 그 자리에서 고릅니다.
• 선택한 전략의 손절률·당일청산 등 실제로 걸리는 감시 내용을 확인 창에서 보여 줍니다.
• 외부보유 종목을 목록에 아예 표시하지 않으려면 [시스템 설정 → 매매]의 하이브리드 모드를 끄십시오. 다만 그 경우 해당 종목은 직접 관리해야 합니다.

⚠️ v1.5.5에서 하이브리드 모드가 한 번 켜집니다. 그동안 꺼 두고 쓰셨다면 이번 업데이트에서 한 번만 켜 드립니다. 꺼져 있으면 HTS에서 산 종목을 프로그램이 전혀 알지 못해 손절·익절 감시를 받지 못한 채 계좌에만 남기 때문입니다. 켜져도 표시만 될 뿐 자동으로 매매되지 않으며, 원치 않으시면 다시 끄시면 그 선택은 계속 유지됩니다.

📌 참고 (v1.5.5): HTS에서 매도 주문을 나눠 걸어 둔 종목이 일부만 팔려도 전량 청산으로 처리되어 감시 목록에서 사라지던 문제를 고쳤습니다. 이제 실제로 보유한 수량을 모두 팔았을 때만 청산으로 기록합니다. HTS 매도 주문이 남아 있다는 이유로 보유분이 목록에서 가려지던 문제도 함께 해결되었습니다. 이 문제로 잘못 쌓인 산 기록이 없는 청산 내역은 프로그램 시작 시 한 번 정리되며, 정리된 내역은 당일 재매수 제한·청산 목록·매매 통계에서 빠집니다.

4.3.2 외부 매수 자동 편입 (계좌별 선택)

HTS·MTS에서 급히 산 종목의 매도를 매번 손으로 편입하지 않고 자동매매에 맡기고 싶다면 [설정 → 외부 매수 자동 편입] 을 씁니다. 계좌가 카드로 나열되어 어느 계좌를 켜 두었는지 한 화면에서 볼 수 있습니다.

• 기본은 꺼짐이고, 켜지 않은 계좌의 동작은 4.3.1과 똑같습니다.
• 켜려면 편입할 전략을 직접 지정해야 합니다. 켜는 순간 그 전략의 손절률·당일청산 시각·분할매수 단계가 편입 확인 창과 같은 문장으로 표시됩니다.
• 편입은 외부 매수가 체결되고 증권사 잔고에 반영된 뒤(마지막 체결로부터 약 15초 후) 이루어집니다. 분할 체결 도중에 편입하면 일부 수량이 빠지기 때문입니다.
• 전략이 정지 중이어도 편입은 되며 감시는 일시중지 상태로 시작합니다. 전략을 가동하면 따로 조작하지 않아도 감시가 시작됩니다.

⚠️ 앱이 켜져 있는 동안 관측한 외부 매수 체결만 편입합니다. 앱을 켜기 전부터 들고 있던 장기 보유 종목은 편입되지 않습니다. 켜는 순간 기존 보유 종목 전체가 손절 판정에 들어가는 사고를 막기 위해서입니다.

📌 참고: 지정한 전략이 삭제됐거나 다른 계좌로 옮겨졌으면 다른 전략으로 대신하지 않고 편입하지 않습니다. 자동매매를 중지해 둔 종목(일시중지·매매중지)도 건너뜁니다. 편입했을 때와 하지 않았을 때 모두 사유가 로그에 남습니다.

4.3.3 앱 밖 보유분을 기존 포지션에 합치기

프로그램이 꺼져 있는 동안 HTS에서 이미 들고 있던 종목을 더 사면, 그 수량은 감시 목록에 '외부보유'로 따로 잡힙니다. 앱 장부가 실제 보유보다 적게 남기 때문에 손절·익절·당일청산의 '전량 매도'가 앱이 아는 수량만 팔고 나머지를 계좌에 남겼습니다.

이 차액을 기존 포지션에 합쳐 수량과 매입단가를 증권사 잔고와 똑같이 맞출 수 있습니다.

• 합치기 전 확인 창에서 수량·매입단가·손절가·익절가가 각각 어디에서 어디로 바뀌는지 보여 줍니다.
• 분할매수·분할매도의 진행 단계는 그대로 유지되며, 합쳐진 수량은 매매 통계의 매수 금액에도 반영됩니다.
• 자동으로 합쳐지면 화면 알림과 로그에 몇 주가 합쳐졌고 매입단가가 어떻게 바뀌었는지 남습니다.

⚠️ 매입단가가 바뀌면 손절선도 함께 움직입니다. 합친 직후 곧바로 매도가 나갈 수 있는 경우에는 확인 창이 먼저 알려 줍니다.

📌 참고: 앱이 켜져 있는 동안의 외부 추가 매수는 예전부터 기존 포지션에 곧바로 합쳐졌습니다. 이 기능이 메우는 것은 앱이 꺼져 있던 동안 산 몫입니다.

4.3.4 종목별 자동매매 일시중지

갑작스러운 악재·호재가 있을 때 특정 종목의 자동매매만 잠시 멈출 수 있습니다.

• 종목을 체크하고 우클릭 → [선택 종목 자동매매 중지]
• 되돌릴 때는 같은 메뉴의 [선택 종목 자동매매 재개]
• 프로그램을 껐다 켜도 중지 상태는 유지됩니다.

⚠️ 주의: 중지 중에는 매수뿐 아니라 손절·익절·당일청산도 함께 멈춥니다. 재개 전까지는 자동 보호가 없습니다. 보유 주식은 그대로 유지되고 직접 매도는 언제든 가능합니다.

4.3.5 상태 배지 읽는 법

📌 참고: 우클릭 메뉴의 [선택 종목 삭제] 는 기본으로 숨겨져 있습니다. 실제 매도가 아니라 감시 목록에서만 빼는 기능이지만, 보유 종목에 실행하면 손절·익절 등 자동 감시가 중단되기 때문입니다. 오류 종목 정리처럼 꼭 필요할 때만 [시스템 설정 → 표시]에서 켜십시오.

표시 설정 — 목록 오른쪽 위 톱니 버튼으로 여는 창에서 당일 청산 종목 표시를 켜면 오늘 청산된 포지션도 목록에 함께 보여 실현 손익을 확인할 수 있습니다.

📌 참고: 매수 주문이 하루 종일 한 주도 체결되지 않으면 수량 0인 기록이 남는데, 다음 날 프로그램 시작 시 자동으로 정리됩니다. 보유 중이거나 주문이 걸려 있는 종목은 건드리지 않습니다.

4.4 실시간 체결 현황 (우측)

시간·계좌·종목·구분·체결 수량/단가/금액을 실시간으로 표시합니다.

구분 열은 이 체결이 어디서 나온 것인지 보여 줍니다 — "자동 매도", "수동 매도", "외부 매수"처럼 표시되며, 자동매매가 낸 것인지, 프로그램에서 직접 낸 것인지, HTS 등 밖에서 낸 것인지 구분됩니다. 프로그램을 다시 켜도 유지됩니다. 구분 열 제목을 누르면 매수·매도로 묶고 그 안에서 자동 → 수동 → 외부 순으로 정렬됩니다.

4.4.1 체결 내역 — 지난 체결 다시 보기 (v1.7.4)

키움 HTS에서는 날짜별 체결은 볼 수 있어도 체결 시각은 확인할 수 없어, "신호가 온 뒤 몇 초 만에 체결됐는지" 알 방법이 없었습니다. [설정 → 체결 내역] 또는 실시간 체결 현황 오른쪽 위의 달력 버튼으로 여는 창에서 지난 체결을 날짜별로 봅니다.

체결과 조건검색 신호 맞춰 보기 — 표에서 체결을 하나 고르면 아래에 그날 같은 계좌·같은 종목의 조건검색 신호가 시각순으로 나오고, 각 신호가 체결보다 몇 초 앞섰는지 함께 보여 줍니다.

• 체결 직전에 같은 방향 주문을 낸 신호를 찾아 "▶ 이 체결" 로 표시하고 위에 한 줄로 정리합니다.
• 손절·익절·트레일링 스탑·당일 청산처럼 가격 조건으로 나간 체결은 신호와 관계없다고 알려 줍니다.
• 체결 뒤에 온 신호는 흐리게 표시됩니다. 체결의 원인이 될 수 없기 때문입니다.

⚠️ 조건검색 신호는 보관기간 동안만 남습니다. 보관기간([시스템 설정 → 데이터·진단]의 조건검색 신호 보관기간, 기본 30일)이 지난 날짜는 체결만 나오고 신호는 맞춰 볼 수 없습니다. 이미 지워진 날짜는 되살릴 수 없으니, 오래 보관하려면 미리 늘려 두십시오.

📌 참고: 이 프로그램이 관리하지 않는 종목(편입하지 않은 종목)을 HTS·MTS에서 매매한 체결은 기록되지 않습니다. 실시간 체결 현황에는 이번 실행 동안 보이지만 체결 내역에는 나오지 않으니 키움 HTS에서 확인하십시오.

4.5 상단 지수 · 로그 · 실시간 등록 현황

4.5.1 상단 지수 표시

화면 맨 위에 띄울 지수를 직접 고를 수 있습니다. [시스템 설정 → 표시]에서 선택하며, 개수 제한은 없습니다.

• 기본값은 국내 KOSPI · KOSDAQ 이고, 해외 지표는 5종 모두 켜져 있습니다. (v1.5.9에서 추가된 VIX는 해외 지표를 직접 골라 저장해 둔 적이 있다면 꺼진 상태로 시작합니다.)
• 저장 즉시 반영되며 재시작이 필요 없습니다.
• 3개 이상 켜면 등락 표기가 퍼센트만으로 짧아지고, 등락폭은 칩에 마우스를 올리면 툴팁으로 보입니다.
• 장 시간 밖에도 국내 지수의 등락이 표시됩니다. 마지막 거래일 기준이며, 어느 날 기준인지는 툴팁에 적힙니다.

⚠️ 해외 지표는 외부 서비스에서 가져옵니다. 키움 API는 국내주식 전용이라 해외지수·환율·유가를 제공하지 않습니다. 그래서 이 값들만은 외부 공개 데이터(야후 파이낸스)를 1분마다 조회해 채웁니다.

국내 지수 칩과는 이름 색으로 구분되며, 칩에 마우스를 올리면 출처와 갱신 시각이 나옵니다.

📌 참고: 자주 요청 주시는 코스피 야간선물은 넣지 못했습니다. 키움 API에 파생상품 시세가 없고, 무료 공개 출처에도 해당 계약이 없습니다.

4.5.2 로그 · 실시간 등록 현황

• 하단 로그 패널(기본 접힘)에 실시간 거래·시스템 이벤트가 기록됩니다.
• 하단 실시간 등록 현황 상태바에 계좌별 시세·조건 실시간 등록 건수가 표시되며, 클릭하면 요청 제한 안내 팝업(시세 최대 190종목, 조건검색식 최대 9개 등)을 볼 수 있습니다. (11.1)
• [조건] 수치에 마우스를 올리면 계좌별로 등록된 조건검색식 이름과 그것을 쓰는 전략 이름이 나옵니다. "내 전략은 6개뿐인데 왜 자리가 찼는지"를 여기서 확인합니다. 어떤 전략도 쓰지 않는데 자리만 차지한 항목은 '사용 중인 전략 없음' 으로 표시되며(재접속 과정에서 남을 수 있음), 프로그램을 다시 시작하면 정리됩니다. 한도 초과로 전략 시작이 거부될 때도 같은 내역이 오류 창에 실립니다.