키움 REST 수동매수 후 자동매도 — 사는 건 사람, 파는 건 프로그램

01두 계좌, 두 규칙

의뢰인은 계좌 두 개를 쓰면서 각각 다른 매도 원칙을 손으로 지키고 있었습니다. 문제는 매일 15:20 전에 종목마다 봉을 세고 5일선을 확인해야 한다는 것, 그리고 그걸 하루라도 빼먹으면 원칙이 무너진다는 것이었습니다.

추적 대상은 프로그램을 켠 뒤 새로 산 종목만입니다. 시작 시점의 잔고는 기준선으로 잡아 두고 건드리지 않습니다. 원래 들고 있던 종목도 규칙에 넣고 싶으면 [기존 보유 추적] 버튼으로 골라서 올릴 수 있습니다. 익절·손절 개념은 없고, 조건이 맞으면 보유 전량을 한 번에 시장가로 냅니다.

0215:19:30에 판정하고, 15:20:00에 쏜다

단순해 보이는데 실제로는 시각 문제가 이 프로젝트의 절반이었습니다. 하루 흐름은 이렇습니다.

• 09:00 시작. 잔고 기준선 확인, 어제까지 추적 상태 복원. 자동매도 스위치는 항상 꺼진 채로 시작합니다. 재시작만으로 매도가 나가면 안 되니까요.
• 장중 잔고를 주기적으로 보며 새로 산 종목이 생기면 추적에 올립니다. 카운트는 저장하지 않고 매번 일봉을 다시 받아 셉니다. 그래서 며칠 꺼져 있어도 보정 코드 없이 숫자가 맞습니다.
• 15:19:30 종목별로 판정하고 결과를 얼립니다. 이 30초 사이에 시세 한 틱으로 대상이 바뀌면, 매매기록에는 매도신호가 남았는데 주문은 안 나가는 어긋남이 생깁니다. 화면의 상태 열도 이 얼린 결과를 따라갑니다.
• 15:20:00 얼려 둔 대상에만 시장가 전량 매도(trde_tp=3, 단가 공백). 발송 여부는 그 자리에서 저장합니다.
• 15:30 잔고 감소를 확인하고 추적을 닫습니다.

종목이 많으면 판정 시각을 자동으로 앞당깁니다. 키움 REST는 api-id마다 요청 간격 제한이 있어 N종목 판정에 N × 간격만큼 시간이 들고, 그걸 15:20 안에 못 끝내면 그날 매도가 통째로 빠집니다. 프로그램이 필요한 만큼 당기고(09:00이 하한) 그 사실을 화면에 띄웁니다.

03고치고 나서야 알게 된 것들

납품 전에 기법을 바꿔 가며 "10라운드 연속 결함 0건"이 나올 때까지 자가 디버깅을 돌렸습니다. 1차 31라운드에서 23건, 2차 10라운드에서 10건. 그중 다른 프로젝트에도 옮겨 붙는 것만 적습니다.

• 잔고를 못 읽은 것과 잔고가 빈 것을 같은 값으로 돌려주고 있었다 — 잔고 조회 응답에서 수량 필드명을 못 찾으면 빈 dict를 반환했는데, 엔진은 잔고에서 사라진 종목을 "전량 매도됨"으로 처리합니다. 스키마가 조금만 달라져도 팔리지도 않은 종목이 체결완료로 기록되고 추적에서 지워질 뻔했습니다. 지금은 예외를 올려 "직전 상태 유지" 경로를 탑니다.
• 납품 검사 테스트 파일이 한 번도 실행된 적이 없었다 — 배포 설정이 모의투자 서버·계좌 2 비활성인지 검사하는 파일 이름이 verify_requirements.py였는데, pytest 기본 수집 패턴은 test_*.py입니다. 초록불만 보고 넘어갈 뻔했습니다. 수집 패턴을 넓히고, "테스트를 썼다"와 "테스트가 돈다"를 따로 확인하게 했습니다.
• 부정형 체크박스가 실거래 사고 후보였다 — "[ ] 매수 당일 봉은 판정에서 제외"라는 체크박스를 고객이 반대로 이해하면 산 날 15:20에 바로 팔립니다. 고객이 "선택할 수 있게 해 달라"고 요청했는데 기능은 이미 있었습니다. 찾을 수 없는 기능은 없는 기능입니다. 2지선다 드롭다운으로 바꿨습니다.
• 아무것도 검증하지 않던 테스트 — 09:00 하한 클램프를 검증한다는 테스트가 클램프가 발동하지도 않는 시나리오였습니다. 뮤테이션 테스트(수정을 되돌린 코드로 테스트가 실패하는지 확인)가 잡았습니다. 29개 뮤턴트 전부 잡힐 때까지 고쳤습니다.
• Windows 기본 압축이 규격 위반 zip을 만든다 — PowerShell Compress-Archive가 경로 구분자를 역슬래시로 써서 반디집·알집·파이썬이 거부합니다. 탐색기에서는 열리니 모릅니다. 납품 zip은 파이썬으로 만들고 만든 직후 다시 열어 검사합니다.

04납품물

• Windows 실행 파일(64bit, 영웅문 불필요) + config.json + .env 템플릿
• PyQt5 화면 — 계좌별 탭, 설정, 로그, [기존 보유 추적] 다이얼로그
• 일자별 매매기록 CSV, 롤링 로그(30일)
• 워드 사용설명서 38쪽 — 설명서 문구와 GUI 라벨·기본값을 기계로 대조하는 검사까지 붙였습니다(문제 해결 장에 옛 이름이 남아 고객이 물어본 뒤 만든 것)
• 자동 테스트 382개 — 실계좌·네트워크 없이 전부 돌아갑니다

05자주 묻는 것

텔레그램 알림은 없나요?

이 건은 없습니다. 의뢰인이 장중에 화면을 보고 있는 분이라 요청에 없었고, 안 넣는 게 값도 쌉니다. 필요하면 하루면 붙습니다.

모의투자로 먼저 돌려볼 수 있나요?

됩니다. 설정에서 모의/실전을 바꾸면 프로그램을 다시 켜지 않아도 다음 [시작]부터 적용됩니다. 처음엔 "재시작 필요" 안내가 붙어 있었는데, 서버 주소를 들고 있는 객체만 다시 만들면 되는 일이었습니다. 앱키 발급 절차는 키움 REST 앱키 발급 가이드에 있습니다.

규칙을 바꾸고 싶으면요?

봉 개수, 이동평균 기간, 판정 시각, 계좌별 활성 여부는 설정 화면에서 바꿉니다. 판정 로직 자체가 입력(일봉 목록, 매수일)만 받는 순수 함수라 "3봉 누적", "20일선 이탈" 같은 변형은 코드 몇 줄입니다.

06관련 사례 · 더 보기

시장가 매도 요청의 실제 형태는 키움 REST API 주식 주문 — kt10000과 trde_tp에 있습니다.