KB증권 Open API란? 시세·계좌 조회부터 자동매매 연동까지

Open API가 무엇인가요?

Open API는 KB증권이 가진 투자 기능을 외부 프로그램이 가져다 쓸 수 있도록 ‘창구’를 열어 주는 서비스예요. 어려운 이름 같지만, 식당에 비유하면 쉽게 이해할 수 있어요.

우리가 식당에서 밥을 먹을 때, 주방에 직접 들어가 요리하지 않죠. 대신 메뉴판을 보고 주문하면 원하는 음식이 나와요. 여기서 ‘메뉴판과 주문 창구’ 역할을 하는 것이 바로 API예요. 손님(내 프로그램)이 정해진 방식으로 요청하면, 주방(KB증권 시스템)이 알아서 처리해 결과(시세·잔고·주문 결과)를 돌려주는 거죠.

앞에 붙은 ‘오픈(Open)’은 이 창구를 KB증권 고객에게 열어 둔다는 뜻이에요. 그동안 HTS·MTS 같은 증권사 앱 ‘안에서만’ 보던 투자 정보를, 이제는 내가 원하는 프로그램이나 도구로 가져와 내 방식대로 보고 활용할 수 있게 된 거예요.

KB증권 Open API로 뭘 할 수 있나요?

KB증권 Open API의 주요 기능과 인증 방식은 다음과 같아요. 시세·계좌 같은 데이터를 가져오는 것부터, 주문을 연결하고, 이를 자동화하는 것까지 이어지죠.

KB증권 Open API 주요 서비스 (출처: KB증권 Open API 포털, openapi.kbsec.com)

그래서 실제로는 이런 것들을 만들 수 있어요. KB증권 계좌와 Open API 서비스 신청 후 발급받은 인증키로 아래와 같은 서비스를 구현해 볼 수 있어요. 이용 가능한 고객·계좌 종류는 포털에서 확인 해 보세요!

어떻게 시작하나요? (4단계)

KB증권 Open API는 ‘계좌 개설 → 서비스 신청 → 인증키 발급 → 개발 연동’ 네 단계로 시작해요. 순서대로 따라가면 어렵지 않아요.

개발자를 위한 간단 기술 맛보기

여기서부터는 직접 개발해 보고 싶은 분들을 위한 내용이에요. 코딩이 낯설다면 이 부분은 가볍게 훑고 넘어가도 괜찮아요.

KB증권 Open API는 인증키로 ‘토큰’을 발급받아 사용해요. 인증키(App Key·Secret Key)가 건물 출입증이라면, 토큰은 그 출입증으로 받은 일정 시간만 유효한 접근 토큰(입장 팔찌)이라고 생각하면 쉬워요. 매 요청마다 이 팔찌(토큰)를 보여 주면 KB증권 서버가 확인하고 데이터를 내어 주는 방식이죠.

요청과 응답은 모두 JSON 형식이고, 인증은 Client Credentials 방식을 사용해요. 또 개발 편의를 위해 Java · Python · JavaScript · PHP · Ruby 샘플 코드 생성과 모의거래 체험 기능도 제공해요. 자세한 제공 범위와 이용 방법은 최신 포털 안내에서 확인하세요.

# Base URL: https://developer.kbsec.com:32484
POST /oauth2/token
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "App key": "{App Key}",
  "App Secret": "{Secret Key}"
}

시작 전 꼭 알아두세요

마지막으로, 시작하기 전에 확인하면 좋은 점들을 정리했어요. 특히 Open API는 현재 베타로 운영 중이라는 점을 기억해 주세요.

KB증권 Open API 서비스 오픈 안내 (출처: KB증권 Open API 서비스 오픈 안내 공지, 2026-06-26)