키움증권 자동매매 프로그램
맞춤 제작

키움증권 OpenAPI+ 기반으로 조건검색 기반 매수·매도, 실시간 시세 모니터링, 자동 주문 체결, 텔레그램 알림까지 하나의 프로그램에 담아드립니다. 알고랩(AlgoLab)이 지난 4년간 키움 자동매매 120건 이상 제작하며 축적한 노하우를 반영합니다.

키움 자동매매로 무엇이 가능한가요?

고객이 직접 짜놓은 전략을 자동화하는 것이 핵심입니다. 수동으로 조건검색 → 매수 → 손절·익절 관리까지 하면 장 시간 내내 모니터링해야 하고, 감정이 개입되거나 타이밍을 놓치는 일이 생깁니다. 자동매매 프로그램은 이 흐름 전체를 PC에 위임합니다.

자주 제작하는 키움 자동매매 유형

• 조건검색식 기반 자동매매 — HTS에서 만든 조건검색식을 API로 불러와, 검색에 걸리는 종목을 자동 매수 → 익절·손절 기준 도달 시 자동 청산
• 시총 상위 스크리닝 + 뉴스 필터 — 시총 상위 100위 안에서 조건 만족 종목 중, 네이버 뉴스에 최근 1시간 이내 관련 기사가 있는 종목만 매수
• RSI·MACD·볼린저 지표 기반 — 일봉·분봉 지표가 설정한 값에 도달하면 진입·청산 (파라미터 최적화 옵션)
• 돌파·갭 상승 전략 — 장 시작 직후 전일 고점 돌파 시 매수, 장 마감 10분 전 전량 청산
• 주도주 추종 + 트레이딩뷰 웹훅 연동 — 외부 Pine Script 시그널을 키움 실거래로 자동 전달

기술 구조

키움 OpenAPI+는 Windows 전용 OCX 방식이라 몇 가지 제약이 있습니다. 알고랩은 이 제약을 전부 고려해서 안정적으로 돌아가는 구조로 제작합니다.

핵심 기능 구성 요소

• TR 요청 모듈: 주식 기본 정보(opt10001), 일봉(opt10081), 분봉(opt10086) 등 조회성 요청 직렬화 관리 (TR Busy 가드 포함)
• 실시간 시세 처리: SetRealReg로 최대 100종목 등록, OnReceiveRealData 콜백 기반 체결 감지
• 주문 모듈: SendOrder 9-arg list 형식으로 안정적 주문 (조용한 실패 방지)
• 조건검색 연동: GetConditionLoad → SendCondition으로 HTS에서 만든 조건검색식 호출
• 체결·잔고 통보: OnReceiveChejanData 콜백으로 실시간 체결/잔고 동기화
• 안전장치: 일일 최대손실 한도, 긴급 중단 버튼, 예수금 부족 방어

OpenAPI+로 남을까, REST로 갈까

상담에서 가장 먼저 갈리는 질문입니다. 정답은 하나가 아니라 지금 무엇을 갖고 계신가에 따라 달라집니다.

정리하면 새로 만드는 경우 REST, 이미 OpenAPI+ 봇이 돌고 있고 문제가 없다면 유지가 기본선입니다. 다만 "PC를 계속 켜 둬야 한다"가 불편해지기 시작했다면 그때가 전환 시점입니다 — 실제로 전환 의뢰의 대부분이 성능이 아니라 운영 피로 때문에 들어옵니다. 전환은 매매 규칙을 다시 짜는 일이 아니라 증권사와 대화하는 층만 바꾸는 작업이라, 전략 로직이 잘 분리돼 있는 봇일수록 빠르게 끝납니다.

REST로 붙으면 실제 코드는 이렇게 생겼습니다

"맡기면 뭘 만들어 주는 건가"가 잘 안 그려지신다면, 봇이 장중에 반복하는 호출을 직접 보시는 편이 빠릅니다. 아래는 키움 REST API 공식 명세 기준의 최소 형태입니다(값은 예시).

# ① 접근토큰 — POST /oauth2/token
{
  "grant_type": "client_credentials",
  "appkey":     "AxserEsdcredca.....",
  "secretkey":  "SEefdcwcforehDre2fdvc...."
}
# 응답
{ "expires_dt": "20241107083713", "token_type": "bearer", "token": "WQJCwyqInphKnR3bSRtB9NE1lv..." }

# ② 매수 주문 — POST /api/dostk/ordr   (헤더 api-id: kt10000)
{
  "dmst_stex_tp": "KRX",      # 거래소 구분 (KRX / NXT)
  "stk_cd":       "005930",   # 종목코드 6자리
  "ord_qty":      "10",       # 주문수량
  "ord_uv":       "71800",    # 주문단가
  "trde_tp":      "0"         # 매매구분 (0 지정가 / 3 시장가)
}

# ③ 미체결 확인 — POST /api/dostk/acnt   (헤더 api-id: ka10075)
{ "all_stk_tp": "0", "trde_tp": "0", "stex_tp": "0" }
# 응답의 목록 이름은 oso, 남은 수량은 oso_qty

※ 위 API ID·경로·항목명은 2026-08-20 시점 키움증권 REST API 공식 명세 기준이며, 증권사 명세는 예고 없이 바뀔 수 있으므로 실제 구현 전 개발자 포털에서 현재 값을 확인합니다.

조건검색식은 실제로 어떻게 연결되나

이 페이지가 처음부터 말하는 "조건검색식 연동"이 코드로는 어떻게 생겼는지 궁금하실 수 있습니다. 조건검색은 다른 기능과 달리 GET·POST 엔드포인트가 아니라 WebSocket 위에서 JSON 메시지를 주고받는 구조입니다. 그래서 붙이는 방식이 통째로 다릅니다.

# wss://api.kiwoom.com:10000/api/dostk/websocket 접속 후 순서

{ "trnm": "LOGIN",   "token": "<access_token>" }   # ① 인증
{ "trnm": "CNSRLST" }                              # ② 내 조건식 목록 + seq(일련번호)
{ "trnm": "CNSRREQ", "seq": "003", "search_type": "1" }  # ③ 검색 요청
#    search_type "0" = 단발 조회 / "1" = 실시간 등록(편입·이탈이 계속 들어옴)
{ "trnm": "CNSRCLR", "seq": "003" }                # ④ 실시간 해제

해외주식·미국주식도 되나요

문의가 가장 많이 갈리는 지점입니다. 결론부터 말씀드리면 "키움 API"라는 한 이름 아래 서로 다른 세 가지가 있고, 미국주식에서 되는 범위가 각각 다릅니다. 국내주식에 있는 기능이 해외에도 그대로 있을 거라고 가정하고 제작을 시작하면 중간에 설계를 바꿔야 합니다. 환전도 국내에는 없던 관문입니다.

무엇이 되고 무엇이 안 되는지, 그리고 스펙이 바뀌었을 때 스스로 확인하는 방법까지 키움 해외주식 API 되나 — REST 미국주식 지원 범위에 정리해 두었습니다. 한국투자증권 KIS 쪽과 비교하고 싶으시면 키움과 KIS, 자동매매용으로 뭐가 다른가를 함께 보시면 됩니다. 상담 때 "국내만 쓸지, 해외까지 갈지"를 먼저 정해 주시면 증권사 선택부터 달라집니다.

제작 비용·기간 가이드

요구사항 복잡도에 따라 편차가 있지만, 키움 자동매매는 대체로 다음 범위 안에서 제작됩니다.

자주 묻는 질문

실거래 하기 전에 모의투자로 먼저 테스트 가능한가요?

네. 키움증권은 모의투자 서버를 별도로 제공합니다. 동일한 OpenAPI+로 접속만 모의계좌로 바꾸면 되기 때문에, 제작 완료 후 1~2주 모의투자로 검증한 뒤 실거래 전환을 권장합니다.

장 마감 후에도 프로그램이 돌아가나요?

시세 TR은 장 시간(09:00~15:30)만 동작하지만, 실시간 종목 모니터링과 일별 전략 결과 집계, 익일 매매 준비 등은 24시간 동작하도록 구성할 수 있습니다. 다만 키움은 야간선물을 지원하지 않습니다(키움 Open API+ 공식 답변 2026-06-11 "현재 야간선물 상품 지원계획은 없습니다" — REST·OpenAPI+ 모두 불가). KRX 야간거래(18:00~익일 06:00) 자동매매가 필요하면 야간 전용 TR을 공식 제공하는 한국투자증권 KIS 기반으로 별도 제작합니다.

여러 증권사 계정을 동시에 돌릴 수 있나요?

키움 OpenAPI+ 특성상 1계정당 1개 프로그램 인스턴스만 실행 가능합니다. 여러 계정을 쓰시려면 계정별로 별도 PC 또는 VM을 준비하셔야 합니다. 견적 상담 시 구성을 함께 설계해드립니다.

조건검색식은 제가 직접 만들어야 하나요?

네, 조건검색식은 고객님이 HTS에서 직접 만드신 뒤 API가 그걸 호출하는 방식입니다. 조건 자체 설계가 어려우시면 상담 시 대안(이동평균·RSI·돌파 등 코드 레벨 구현)을 함께 검토해드립니다.

조건검색 자동매매가 새벽에 멈춰 있던 적이 있다던데요?

실시간 조건검색은 WebSocket 연결 위에서 돌아가는데, 서버가 보내는 PING에 응답하지 않으면 세션이 조용히 끊어집니다. 에러가 안 나서 프로그램은 정상으로 보이는데 편입 신호만 안 들어오는 상태가 됩니다. 알고랩이 제작하는 프로그램에는 PING 응답과 자동 재연결, 그리고 끊김을 텔레그램으로 알리는 감시를 기본으로 넣습니다.

제작 사례

지난 1년간 알고랩에서 제작한 키움 자동매매 주요 사례는 포트폴리오 페이지에서 보실 수 있습니다. 대표 사례: 주도주 스크리닝 + 트레이딩뷰 웹훅 연동 자동매매, 조건검색식 + 네이버 뉴스 필터 자동매매, LS증권·키움 복합 뉴스 감지 자동매매 등.

키움 REST API 기반 최근 사례도 있습니다 — 이동평균 골든/데드크로스 2종목 봇, PSAR+MACD 15분봉 단타 봇, 멀티슬롯 다중 PC 종목풀 동기화. OpenAPI+와 REST 중 무엇을 쓸지부터 정하시려면 → 키움 REST API vs OpenAPI+ 차이, 인증키 발급 화면은 → 키움 REST API 인증키 발급 가이드.