STOCK API HUB · DEVELOPER GUIDE

KB증권 OpenAPI 가이드

KB증권 OpenAPI의 OAuth 인증·국내주식·해외주식 명세를 살펴보세요. 현재 포털에서 제공하는 API와 요청 방식, 인증 및 공식 출처를 안내합니다.

KB증권 API는 현재 포털에서 제공하는 AS-IS REST 명세를 기준으로 안내합니다. OAuth 인증 후 국내주식·해외주식의 시세와 계좌 관련 요청을 찾아볼 수 있습니다. 과거 통합 카탈로그의 다른 전송 방식과 혼동하지 않도록 현재 포털과 같은 목록을 사용합니다.

KB증권 API 한눈에 보기

현재 Stock API Hub의 KB REST 테스트는 운영 환경만 제공합니다. 모의투자나 실시간 수신 지원을 의미하지 않습니다.

아래는 현재 허브 카탈로그의 분류입니다. 증권사의 전체 상품 지원이나 모든 API의 테스트 가능 여부를 뜻하지 않습니다.

국내주식과 해외주식의 현재가·잔고 명세를 비교하고, 요청에 필요한 업무코드와 계좌 구분값을 확인하는 데서 시작하세요.

인증 명세를 먼저 열고 운영 환경과 키 발급 환경을 맞추세요. 필요한 기능을 고른 뒤 요청·응답 필드와 필수값을 확인하고, 포털에서 테스트를 지원하는 명세에 한해 요청을 실행할 수 있습니다.

인증과 주요 조회·주문 기능에서 선별한 14개 명세입니다. 기능명은 카탈로그 원본을 사용하며, 아래 API 이름을 누르면 해당 포털 명세가 열립니다.

API	방식	TR / 업무코드	엔드포인트
토큰 발급OAuth 인증 · 인증	POST	`token`	`/oauth2/token`
현재가국내주식 · 기본시세	POST	`IVU10140`	`/api/v1/ivu10140`
현재가해외주식 · 기본시세	POST	`GSS10030`	`/api/v1/gss10030`
매도주문국내주식 · 주식주문	POST	`SSAM1801`	`/api/v1/ssam1801`
매수주문국내주식 · 주식주문	POST	`SSAM1802`	`/api/v1/ssam1802`
정정주문국내주식 · 주식주문	POST	`SSAM1805`	`/api/v1/ssam1805`
보유주식 조회국내주식 · 계좌잔고	POST	`SSQM1801`	`/api/v1/ssqm1801`
잔고현황 조회(결제기준)국내주식 · 계좌잔고	POST	`SSQM2932`	`/api/v1/ssqm2932`
잔고현황 조회(체결기준)국내주식 · 계좌잔고	POST	`SSQM2952`	`/api/v1/ssqm2952`
체결미체결 조회국내주식 · 주문내역	POST	`SSQM2341`	`/api/v1/ssqm2341`
주문체결조회해외주식 · 주문내역	POST	`SPQM2103`	`/api/v1/spqm2103`
체결미체결 조회해외주식 · 주문내역	POST	`SPQM2204`	`/api/v1/spqm2204`
증시주변자금동향국내주식 · 투자정보	POST	`IVA10370`	`/api/v1/iva10370`
세계지수국내주식 · 투자정보	POST	`IVA60140`	`/api/v1/iva60140`

현재가 조회를 계좌 잔고와 분리해 표시하고, 가격 기준 시각과 통화를 함께 보여주는 화면을 구성합니다.

주문번호를 저장한 뒤 체결·미체결과 잔고를 대조하는 흐름을 설계합니다. 필요한 명세의 지원 여부를 먼저 확인하세요.

API 개수와 분류는 현재 Stock API Hub에 등록된 명세 기준입니다. 변경된 조건과 호출 제한은 공식 문서를 확인하세요.

연결에 성공한 작은 예제도 다른 개발자의 출발점이 됩니다. 사용한 증권사와 API 이름, 구현 목적, 해결 과정을 API 활용 레시피에 남겨 주세요. 오류를 질문할 때는 재현 조건과 오류 코드를 적고 계좌번호·토큰·앱키는 지워 주세요.