키움 REST 이동평균 골든/데드크로스 2종목 자동매매 봇

01배경과 고객 요구사항

고객은 이동평균선 골든크로스와 데드크로스로 매매하는 규칙을 이미 갖고 있었습니다. 다만 봉이 마감될 때마다 직접 차트를 보고 주문해야 했습니다. 2종목을, 그것도 15분봉이나 30분봉처럼 자주 마감되는 봉을 계속 지켜보기는 어려웠습니다.

요청은 이랬습니다. 선택한 시간봉이 마감된 시점을 기준으로 크로스를 판단할 것, 2종목을 각각 따로 운용할 것. 그리고 정규장(09:00~15:30)에 더해 대체거래소 넥스트레이드(NXT)의 연장시간, 곧 장 시작 전과 마감 후에도 거래할 것.

NXT 연장시간은 자동매매 봇이 잘 다루지 않는 구간이라, 여기서 주문이 실제로 나가느냐가 관건이었습니다. 정규장과 연장시간은 주문 방식과 거래소 경로가 달라서, 시간대에 따라 주문 방식을 바꿔 보내는 처리가 필요했습니다.

02구현 방식

봉이 마감되면 크로스를 판단하고, 그 시각에 맞는 경로로 주문을 보냅니다.

• 선택한 시간봉(15분~4시간)이 완전히 마감된 뒤에만 이동평균을 계산합니다. 봉이 만들어지는 중에 잠깐 나타났다 사라지는 신호는 쓰지 않습니다.
• 단기(10) SMA가 장기(34) SMA를 위로 돌파하면 매수, 아래로 돌파하면 매도로 판단합니다.
• 키움 신 REST API로 시간대에 맞는 거래소와 주문 방식을 골라 보내고, 체결은 실제 잔고로 확인합니다.
• 화면에는 2종목의 이동평균, 이격도, 포지션, 평가손익과 현재 주문 경로가 실시간으로 표시됩니다.

시세는 REST 조회와 실시간 WebSocket 두 가지로 받습니다. 봉마감 신호는 REST 조회로 충분합니다. 그런데 NXT 연장시간에는 REST 시세가 정규장 종가에 멈추는 구간이 있어서 실시간 WebSocket으로만 시세를 받을 수 있습니다. WebSocket이 끊기면 REST로 넘어가 매매를 이어갑니다.

이격도는 단기 SMA를 장기 SMA로 나눈 값에 100을 곱해 구하고, 매도 단계를 판단할 때 씁니다. 4시간봉은 60분봉을 날짜 경계에 맞춰 합쳐서 만들었습니다. 크로스, 이격도, 손절 기준값은 모두 화면에서 직접 고칠 수 있어서 종목이나 기준값을 바꿀 때 개발자를 부를 필요가 없습니다.

03어려웠던 부분

• 정규장은 SOR 시장가, 연장시간은 NXT 지정가로 시각에 따라 주문 경로가 정해집니다. 사용자는 시간대를 신경 쓸 필요가 없습니다.
• 연장시간에 REST 시세가 멈추는 문제는 실시간 WebSocket 구독으로 풀었습니다. 장 마감 후에도 실제 현재가로 판단합니다.
• 지정가가 몇 초 안에 체결되지 않으면 취소하고, 가격 여유를 넓혀 다시 주문합니다.
• 주문을 보냈다고 보유로 치지 않습니다. 증권사 잔고로만 체결을 확정하므로 일부만 체결되거나 체결되지 않아도 수량이 어긋나지 않습니다.
• 접근 토큰이 만료되거나 중복 발급되면 감지해서 다시 발급받습니다. 사람이 없는 동안에도 인증이 끊기지 않습니다.

04주요 기능

• 단기(10)/장기(34) SMA 골든크로스와 데드크로스로 자동 매수, 매도합니다. 판단은 봉마감 기준입니다.
• 매도는 5단계 우선순위를 따릅니다. 손절, 이격도(2단계), 데드크로스, 고점 대비 순이고, 여러 조건이 동시에 충족돼도 한 번만 실행합니다.
• 2종목을 동시에 운용하며 종목별로 투자금, 포지션, 기준값을 따로 관리합니다.
• 시간봉은 15분, 30분, 1시간, 4시간 중에서 화면에서 고릅니다.
• 파라미터는 파일로 저장하고 불러올 수 있고, 신호와 체결은 날짜별 로그에 남습니다.

05제작 과정 (약 2~3주)

• 1주차에 크로스와 매도 규칙을 확정하고, 키움 신 REST API의 인증, 주문, 잔고, 분봉 조회와 실시간 WebSocket 시세의 뼈대를 만들었습니다.
• 2주차에는 봉마감 크로스와 이격도 계산, 5단계 우선순위 매도, 시간대별 주문 경로, 미체결 취소와 재주문, 화면을 구현했습니다.
• 3주차에 클라우드 서버에 배포하고 토큰 재발급과 재접속을 점검했습니다. NXT 연장시간 주문은 소액 실계좌로 매수와 매도를 모두 확인한 뒤 인수인계했습니다.

06납품 결과물

• 실행 프로그램 (GUI 대시보드 포함, .exe)
• 키움 신 REST API 연동과 설정 파일 (종목, 시간봉, 기준값은 화면에서 편집)
• 일자별 신호, 체결, 오류 로그
• 사용설명서, API 키 발급과 서버 설정 가이드
• 납품 후 30일 무료 AS (협의 범위 내)

07기술 스택

08관련 사례