KB증권 Open API 자동매매 — 개인 개방 현황과 신청법

"내 증권사는 KB인데, 자동매매를 하려면 계좌를 옮겨야 하나요?" 상담에서 꾸준히 들어오던 질문입니다. 지금까지의 답은 "네, 옮기셔야 합니다"였습니다. 개인이 쓸 수 있는 국내 주식 API는 한국투자증권·키움증권·LS증권·대신증권 정도로 사실상 굳어 있었기 때문입니다.

그런데 2026년 들어 이 지도가 바뀌었습니다. 토스증권이 개인용 Open API를 열었고, KB증권이 2026년 7월 20일 개인 고객 대상 오픈베타를 시작했습니다. 이 글은 KB증권 건에서 지금 확인할 수 있는 사실과, 아직 확인할 수 없는 것을 분명히 나눠서 정리합니다. 그 다음 "그래서 나는 뭘로 만들어야 하나"에 코드로 답합니다.

1. KB증권이 무엇을 열었나 — 확인된 사실

KB증권은 2026년 8월 4일, 지난달 20일부터 개인 고객 대상 Open API를 오픈베타 형태로 운영 중이라고 발표했습니다. 복수 매체 보도에서 공통으로 확인되는 항목은 아래와 같습니다.

자동매매 관점에서 이 목록을 읽는 법은 간단합니다. 봇 한 바퀴가 도는 데 필요한 네 가지가 다 있느냐를 봅니다 — ① 시세를 읽고 ② 주문을 내고 ③ 잔고를 확인하고 ④ 체결을 확인하는 것. 발표된 범위만 놓고 보면 네 가지가 모두 들어 있습니다. 구조적으로는 키움·KIS와 같은 계열의 REST API로 보는 것이 타당합니다.

2. 아직 확인 안 된 것 — 여기에 속지 말 것

보도자료에는 기능 목록이 있지만 개발 스펙은 없습니다. 그리고 오픈베타 단계에서는 개발 가이드가 신청자에게 제공되는 형태라, 검색으로 나오는 "KB증권 API 엔드포인트" 류의 정보는 추정일 가능성이 큽니다. 알고랩 기준으로 공개 자료만으로는 확정할 수 없는 항목은 다음과 같습니다.

2-1. 2026-08-27 업데이트 — 공식 개발자 포털이 열렸다

이 글을 처음 쓴 시점에는 보도자료뿐이었지만, 2026-08-27 확인 기준으로 KB증권의 개인 Open API 전용 포털 openapi.kbsec.com이 공개돼 있습니다. 위 표에서 확정 못 했던 항목 중 두 개가 여기서 확인됩니다.

3. 신청 절차

발표된 경로는 KB증권 홈페이지 → 고객서비스 → Open API → 본인인증 → 온라인 신청입니다. KIS Developers처럼 개발자 전용 포털에 따로 회원가입하는 방식이 아니라, 이미 계좌를 가진 본인이 홈페이지에서 바로 신청하는 구조라는 점이 다릅니다. 실무적으로는 이런 순서가 됩니다.

1. KB증권 계좌가 있어야 합니다 (없으면 비대면 개설 먼저)
2. 홈페이지 「고객서비스 > Open API」에서 본인인증
3. Open API 이용 신청 및 약관 동의
4. 인증키 발급 — 여기서 받는 값은 절대 코드에 하드코딩하지 말고 .env 같은 별도 파일로 뺍니다
5. 제공되는 개발 가이드로 도메인·엔드포인트·한도 확인
6. 가능하면 소액 실계좌로 첫 주문 1주를 흘려 봅니다

4. 국내 증권사 개인 Open API 지도 2026

KB증권 합류를 포함해, 개인이 접근할 수 있는 국내 증권사 API를 진입점 기준으로 정리하면 이렇습니다. 기능 비교는 증권사 API 비교 글에 따로 있고, 여기서는 "문이 열려 있느냐"만 봅니다.

5. "내 증권사엔 API가 없다"면 선택지 3개

① 매매용 계좌를 하나 더 만든다 — 권장

가장 현실적인 답입니다. 기존 계좌를 해지할 필요가 없습니다. 장기 보유 계좌는 그대로 두고, 봇이 돌릴 자금만 API가 열린 증권사 계좌로 옮기면 됩니다. 비대면 개설이라 하루면 끝나고, 오히려 운영 계좌와 봇 계좌를 물리적으로 분리하는 편이 사고 시 손실 범위를 가둘 수 있어 안전합니다.

② HTS 화면 자동화 — 권하지 않습니다

"API가 없으면 HTS를 마우스로 조작하게 만들면 되지 않나"라는 발상입니다. 기술적으로는 가능합니다.

# 이런 코드입니다 — 그리고 이것이 문제의 전부입니다
import pyautogui, time

pyautogui.click(x=412, y=338)      # '종목코드' 입력칸의 좌표
pyautogui.typewrite('005930')      # 화면 배치가 바뀌면 여기서 끝
pyautogui.click(x=530, y=612)      # '매수' 버튼의 좌표
time.sleep(1)
# 주문이 실제로 접수됐는지 확인할 방법이 없다 —
# 팝업이 떴는지, 잔고가 부족했는지, 화면이 그냥 안 눌렸는지 알 수 없음

실패하는 이유는 좌표가 아니라 확인 불가능성입니다. REST API는 주문을 넣으면 rt_cd나 return_code 같은 성공/실패 코드와 주문번호를 돌려줍니다. 화면 자동화는 아무것도 돌려주지 않습니다. 여기에 증권사 보안 프로그램·세션 만료·업데이트로 인한 화면 변경이 겹칩니다. 실계좌에 붙이는 순간 "주문이 나갔는지 모르는 봇"이 됩니다.

③ 대신증권 CREON처럼 API는 있지만 제약이 있는 경우

대신증권 CREON Plus는 REST가 아니라 COM 객체 방식입니다. 코드 모양이 아예 다릅니다.

# 대신증권 CREON — Windows COM 방식 (32bit 파이썬 필요)
import win32com.client

obj = win32com.client.Dispatch("CpUtil.CpCybos")
print(obj.IsConnect)        # 1이면 CREON Plus에 접속된 상태

stock = win32com.client.Dispatch("DsCbo1.StockMst")
stock.SetInputValue(0, "A005930")
stock.BlockRequest()
print(stock.GetHeaderValue(11))   # 현재가

Windows에서 CREON Plus가 실행 중이어야 하고, 64bit 파이썬으로는 붙지 않습니다. 리눅스 서버에 올려 무인 운영하려던 계획이 여기서 막힙니다. "API가 있다"와 "내 환경에서 24시간 돌릴 수 있다"는 다른 이야기입니다.

6. KB 문서를 기다리는 동안 만드는 법 (실제 코드)

KB증권 가이드를 받기 전에도 봇의 90%는 미리 만들 수 있습니다. 전략·리스크·스케줄러·로깅은 증권사와 무관하기 때문입니다. 남은 10%인 통신 부분만 지금 문서가 열려 있는 증권사로 먼저 검증해 두면 됩니다.

한국투자증권 KIS — 토큰 발급

import requests, json

BASE = "https://openapi.koreainvestment.com:9443"   # 실전
# 모의투자는 https://openapivts.koreainvestment.com:29443

res = requests.post(
    f"{BASE}/oauth2/tokenP",
    headers={"content-type": "application/json"},
    data=json.dumps({
        "grant_type": "client_credentials",
        "appkey":     APP_KEY,      # .env에서 읽어 올 것
        "appsecret":  APP_SECRET,
    }),
    timeout=10,
)
tok = res.json()
print(tok["access_token"][:20], tok["access_token_token_expired"])

이 access_token은 유효시간이 1일이라 매 호출마다 새로 받으면 안 됩니다. 재발급 규칙은 토큰 만료·재발급 규칙에 정리해 두었습니다.

주문 헤더 — 증권사마다 바뀌는 부분은 사실 여기뿐

headers = {
    "content-type":  "application/json; charset=utf-8",
    "authorization": f"Bearer {access_token}",
    "appkey":        APP_KEY,
    "appsecret":     APP_SECRET,
    "tr_id":         "TTTC0802U",   # 국내주식 현금 매수 (모의는 VTTC0802U)
    "custtype":      "P",           # 개인
}
body = {
    "CANO":          CANO,          # 계좌번호 앞 8자리
    "ACNT_PRDT_CD":  "01",          # 뒤 2자리
    "PDNO":          "005930",
    "ORD_DVSN":      "01",          # 01 = 시장가
    "ORD_QTY":       "1",
    "ORD_UNPR":      "0",
}

이 구조를 이해해 두면 KB증권 문서를 받았을 때 읽는 시간이 30분으로 줄어듭니다. 국내 증권사 REST API는 대체로 「인증키 → 토큰 → 헤더에 토큰+거래구분 → 본문에 계좌·종목·수량」 형태로 수렴하기 때문입니다. 바뀌는 것은 도메인, 경로, 거래 구분값의 이름, 응답 필드명 정도입니다.

DB증권 — 같은 패턴의 다른 예

# DB증권 Open API — 토큰 발급 엔드포인트
TOKEN_URL = "https://openapi.dbsec.co.kr:8443/oauth2/token"
# 발급 절차: openapi.dbsec.co.kr에서 API 사용신청 → Appkey / Appsecret 수령
# 제공 예시: 국내주식 주문(시장가) · 현재가 조회 · 주식잔고조회 · 해외주식 실시간 체결가(WebSocket)

도메인만 다르고 /oauth2/token이라는 모양은 같습니다. 토스증권 Open API도 큰 틀은 같습니다. 즉 증권사 하나로 한 번 제대로 만들어 두면 다음 증권사는 훨씬 빠릅니다.

7. 증권사를 갈아탈 수 있게 짜는 구조

오픈베타 시기에 특히 중요합니다. KB증권 스펙이 바뀌거나, 한도가 안 맞아 다른 증권사로 옮겨야 할 가능성을 미리 열어 두는 것입니다. 방법은 하나입니다 — 전략 코드가 증권사 이름을 모르게 만드는 것.

from abc import ABC, abstractmethod

class Broker(ABC):
    """전략은 이 인터페이스만 안다. 증권사 이름을 모른다."""
    @abstractmethod
    def buy(self, code: str, qty: int) -> str: ...      # → 주문번호
    @abstractmethod
    def positions(self) -> list[dict]: ...              # → 보유 종목

class KisBroker(Broker):
    BASE   = "https://openapi.koreainvestment.com:9443"
    ORDER  = "/uapi/domestic-stock/v1/trading/order-cash"
    TR_BUY = "TTTC0802U"
    def buy(self, code, qty):
        r = requests.post(self.BASE + self.ORDER,
                          headers=self._headers(self.TR_BUY),
                          data=json.dumps({...}), timeout=10)
        j = r.json()
        if j["rt_cd"] != "0":                 # KIS는 rt_cd "0"이 성공
            raise BrokerError(j["msg_cd"], j["msg1"])
        return j["output"]["ODNO"]            # 주문번호

class KbBroker(Broker):
    """KB증권 가이드 수령 후 이 클래스만 채운다. 전략 코드는 한 줄도 안 바뀐다."""
    def buy(self, code, qty):
        raise NotImplementedError("KB Open API 가이드 확인 후 구현")

# 전략 쪽
broker: Broker = KisBroker()      # 나중에 KbBroker()로 한 줄 교체
broker.buy("005930", 1)

8. 체크리스트

• KB증권 계좌가 이미 있는지 확인했는가 (없으면 비대면 개설이 먼저)
• 홈페이지 「고객서비스 > Open API」에서 신청을 접수했는가
• 발급받은 인증키를 .env로 분리했는가 — 코드·깃허브에 절대 올리지 않는다
• 추정 스펙으로 개발을 시작하지 않았는가 — 공식 가이드 수령이 먼저
• 도메인·경로·한도를 설정 파일 한 곳에 모았는가 (베타 중 변경 대비)
• 주문·잔고를 Broker 인터페이스로 추상화했는가
• 잔고 조회가 한 번에 다 안 나오는 경우처럼 페이지 잘림 처리를 넣었는가
• 첫 실거래는 1주·소액으로 시작하는가

마무리

정리하면 세 줄입니다. KB증권은 2026년 7월 20일 개인 대상 Open API를 오픈베타로 열었고, 시세·주문·정정·취소·잔고·체결이 발표된 범위이며, 신청은 홈페이지 「고객서비스 > Open API」입니다. 개발 스펙은 신청해서 가이드를 받은 뒤에 확정하는 것이 맞습니다.

그동안 "증권사 때문에 자동매매를 못 한다"고 접어 두셨던 분이라면, 지금이 다시 볼 시점입니다. 선택지가 4곳에서 7곳으로 늘었습니다. 무엇을 만들지부터 정하고 싶다면 제작 비용·견적 기준을 먼저 보시는 편이 순서에 맞습니다.