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

01배경과 고객 요구사항

고객은 한 종목을 15분봉으로 단타 매매하고 있었습니다. MACD 히스토그램과 파라볼릭 SAR 같은 지표를 어떻게 조합해 들어가고 나올지는 이미 정해져 있었습니다. 다만 봉이 닫힐 때마다 직접 화면을 보고 주문을 넣어야 했습니다.

원하신 것은 15분봉이 마감될 때마다 지표를 판정해 진입하고, 여러 매도 규칙을 우선순위대로 적용해 나눠서 청산하고, 정규장이 끝난 뒤에도 NXT 애프터마켓 시간외로 저녁 19:40까지 매도하는 것이었습니다.

가장 어려운 것은 장 마감 후 매도였습니다. KRX 정규장은 15:30에, 시간외단일가는 18:00에 끝나서 KRX만으로는 저녁 시간대에 팔 방법이 없습니다. 단타이다 보니 신호가 뜬 봉이 마감되면 곧바로 주문이 나가야 한다는 조건도 있었습니다.

02구현 방식

국내 주식 자동매매는 보통 키움 OCX(32bit)로 만들지만, 이번에는 키움 신 REST API를 썼습니다. 설치가 필요 없고 NXT 시간외 매도가 되기 때문입니다.

• 15분봉이 완전히 닫힌 뒤의 값으로만 지표를 계산합니다. 아직 진행 중인 봉을 보고 잘못 들어가는 일을 막으려는 것입니다.
• MACD 히스토그램이 늘고 있는지와 PSAR 상향돌파를 함께 확인해 매수합니다. 매도 규칙은 우선순위 순서로 따집니다.
• 정규장에는 KRX 시장가로, 마감 후에는 NXT 애프터마켓 지정가로 주문이 자동으로 바뀌어 나갑니다.
• 실제 체결 결과로 보유 수량을 맞추고, 진입과 청산, 오류를 텔레그램으로 알립니다.

지표 계산은 외부 라이브러리를 쓰지 않고 직접 짰습니다. 실행 파일이 가벼워지고, 계산 결과를 고객이 정한 규칙과 하나씩 맞춰 볼 수 있습니다. 종목, 지표 파라미터, 손절, 매매 시간은 화면에서 직접 바꾸고 저장합니다.

03해결한 기술 난제

• KRX와 NXT 중 한쪽이 막혀 다른 쪽으로 넘어가면 텔레그램으로 상황을 알립니다.
• 체결되지 않은 주문을 다시 낼 때는 취소를 요청한 것만으로는 재주문하지 않습니다. 취소가 확인됐다는 통보가 온 뒤에만 다시 주문합니다. 중복 매수나 보유 수량보다 많이 파는 사고를 막기 위해서입니다.
• 실시간 체결 통보는 가끔 빠질 때가 있습니다. 일정 시간 응답이 없으면 주문을 정리하고, 주기적으로 잔고를 조회해 보유 수량을 바로잡습니다.
• 주문할 수 없는 시간에 뜬 매도 신호는 저장해 뒀다가 장이 열리면 우선순위대로 다시 시도합니다. 프로그램을 껐다 켜도 이 예약은 남아 있습니다.

04주요 기능

• MACD 히스토그램 증가와 PSAR 상향돌파가 함께 충족되면 시장가 전량 매수 (하루 1회)
• PSAR 하향돌파, 15 EMA 이탈, 스토캐스틱 데드크로스, 손절을 우선순위대로 따져 전량 또는 30%, 50% 분할 청산
• 정규장 마감 후 19:40까지 NXT 애프터마켓에서 남은 수량 청산
• 포지션, 체결, 신호 이력을 실시간으로 보여 주는 다크 화면
• 매수, 매도, 손절, 오류, 일일 매매 종료를 알리는 텔레그램 알림
• 사용자가 직접 사고팔면 계좌를 다시 조회해 내부 상태를 맞춤
• 포지션과 예약 매도를 저장해 두어 다시 켜도 이어서 운영

05제작 과정 (약 2주)

• 1주차에는 키움 신 REST의 인증, 주문, 실시간 연동을 잡고, 15분봉 지표 계산과 매수, 매도 규칙을 확정했습니다.
• 2주차에는 화면과 텔레그램 알림을 만들고, NXT 주문 전환을 소액 실계좌에서 사고팔아 확인했습니다. 클라우드에 올린 뒤 넘겨 드렸습니다.

06납품 결과물

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

07기술 스택

08관련 사례