키움 REST PSAR+MACD 15분봉 단타 자동매매 봇

01배경 · 고객 요구사항

고객은 단일 종목을 15분봉으로 단타 매매하고 있었고, 진입·청산에 쓰는 지표 조합 (MACD 히스토그램·파라볼릭 SAR 등)의 규칙은 이미 확실했습니다. 문제는 그 규칙을 사람이 직접 봉이 닫힐 때마다 지켜보며 주문해야 했다는 점이었습니다.

요청은 세 가지였습니다. ① 15분봉이 마감될 때마다 지표 조합을 자동으로 판정해 진입, ② 여러 매도 규칙을 우선순위대로 자동 분할 청산, ③ 정규장이 끝난 뒤에도 NXT 애프터마켓 시간외로 저녁 19:40까지 매도.

특히 "장 마감 후에도 매도"가 핵심 난제였습니다. KRX 정규장(15:30 마감)과 시간외단일가(18:00 마감)만으로는 고객이 원한 저녁 시간대까지 매도가 물리적으로 불가능했기 때문입니다. 단타 특성상 신호가 뜬 봉 마감 직후 즉시 주문이 나가는 속도도 함께 중요했습니다.

02구현 방식

국내 주식은 보통 키움 OCX(32bit)로 붙지만, 이 프로젝트는 키움 신 REST API(REST + WebSocket, 64bit)로 구현했습니다. 무설치·다계정 동시 실행·시간외(NXT) 매도라는 이점 때문입니다. 전체 흐름은 이렇습니다:

• 15분봉 마감 감지 → 봉이 완전히 닫힌 값으로만 지표를 계산해 신호를 확정 (미완성 봉으로 인한 잘못된 진입 방지)
• 지표 판정 → MACD 히스토그램 증가 여부와 PSAR 상향돌파를 함께 확인해 매수, 매도 규칙은 우선순위대로 평가
• 세션별 주문 라우팅 → 정규장은 KRX 시장가, 마감 후에는 NXT 애프터마켓 지정가로 자동 전환
• 체결·잔고 동기화 & 텔레그램 → 실제 체결 결과로 포지션을 맞추고 진입·청산·오류를 즉시 알림

지표는 pandas 같은 무거운 라이브러리 없이 순수 파이썬으로 직접 계산해, 실행 파일을 가볍게 유지하고 계산 결과를 확정 규칙과 1:1로 검증할 수 있게 했습니다. 종목·지표 파라미터·손절·매매 시간은 개발자 호출 없이 GUI에서 직접 조정·저장하도록 만들었습니다.

03해결한 기술 난제

• NXT 세션 라우팅 & 자동 폴백 — 시간대별로 KRX·NXT 주문 경로를 자동 선택하고, 한쪽이 막히면 다른 경로로 넘어가며 텔레그램으로 상황을 통지
• 취소 확인 후에만 재주문 — 미체결 주문을 재발행할 때 취소 "요청"만으로 재주문하지 않고 취소 "확인" 통보가 온 뒤에만 다시 주문해 이중 발주(중복 매수·초과 매도)를 원천 차단
• 통보 누락 이중 확인 — 실시간 체결 통보가 간헐적으로 누락되는 상황에 대비해, 일정 시간 무응답 시 정리(sweep)와 주기적 잔고 조회로 포지션을 스스로 교정
• 예약 매도 영속화 — 주문이 불가능한 시간대에 뜬 매도 신호는 저장해 두었다가 세션이 열리면 우선순위대로 재시도. 프로그램을 재시작해도 청산 예약이 유지

04핵심 기능

• 지표 조합 자동 진입 — MACD 히스토그램 증가 AND PSAR 상향돌파가 함께 충족되면 시장가 전량 매수 (하루 1회)
• 우선순위 분할 매도 — PSAR 하향돌파·15 EMA 이탈·스토캐스틱 데드크로스·손절을 우선순위대로 평가해 전량 또는 분할(30%·50%) 청산
• NXT 애프터마켓 시간외 매도 — 정규장 마감 후에도 저녁 시간대(19:40)까지 잔량 청산
• GUI 다크 대시보드 — 포지션·체결·신호 이력을 실시간 표시, 지표 파라미터·손절·매매 시간을 화면에서 조정·저장
• 텔레그램 실시간 알림 — 매수·매도·손절·오류·일일 매매 종료까지 즉시 통보
• 수동매매 감지 동기화 — 사용자가 직접 사고팔면 계좌를 즉시 재조회해 내부 상태를 자동 갱신
• 재시작 복원 — 포지션·예약 매도 상태를 저장해 프로그램을 다시 켜도 이어서 운영

05제작 과정 (약 2주)

• 1주차 · 연동·전략 설계 — 키움 신 REST 인증·주문·실시간 연동 뼈대 구축, 15분봉 지표 계산과 매수·매도 규칙 확정
• 2주차 · 화면·검증·배포 — GUI 대시보드·텔레그램 알림 구현, NXT 세션 라우팅과 소액 실계좌 왕복 체결 검증, 클라우드 배포 후 인수인계

06납품 결과물

• 실행 프로그램 (.exe · GUI 대시보드 포함)
• 키움 신 REST API 인증·주문·실시간 시세 연동
• 텔레그램 알림 봇 연동
• 사용설명서 + 클라우드 서버·텔레그램 설정 가이드
• 납품 후 30일 무료 AS (협의 범위 내)

07기술 스택

08관련 사례 · 더 보기