STOCK API HUB · DEVELOPER GUIDE

키움증권 OpenAPI 가이드

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

키움증권은 이 허브에서 REST API와 웹소켓 명세를 중심으로 탐색할 수 있습니다. 국내주식·미국주식 카테고리와 공통 안내를 분리해 제공합니다. 기존 데스크톱 OpenAPI+ 사용 예제를 그대로 적용하기 전에 전송 방식과 요청 코드를 확인하세요.

키움증권 API 한눈에 보기

운영·모의투자 앱키를 구분해 사용하세요. 모의투자 지원 범위는 개별 API 명세를 확인하세요.

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

같은 엔드포인트를 여러 요청이 공유할 수 있으므로 API 이름뿐 아니라 업무코드를 함께 비교하세요. 실시간 조건검색과 일반 조회도 구분해야 합니다.

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

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

API	방식	TR / 업무코드	엔드포인트
접근토큰 발급OAuth 인증 · 접근토큰발급	POST	`au10001`	`/oauth2/token`
주식기본정보요청국내주식 · 종목정보	POST	`ka10001`	`/api/dostk/stkinfo`
미국주식 현재가 종목정보미국주식 · 시세	POST	`usa20100`	`/api/us/mrkcond`
미국주식 현재가 10호가미국주식 · 시세	POST	`usa20101`	`/api/us/mrkcond`
주식 매수주문국내주식 · 주문	POST	`kt10000`	`/api/dostk/ordr`
주식 매도주문국내주식 · 주문	POST	`kt10001`	`/api/dostk/ordr`
주식 정정주문국내주식 · 주문	POST	`kt10002`	`/api/dostk/ordr`
계좌평가잔고내역요청국내주식 · 계좌	POST	`kt00018`	`/api/dostk/acnt`
미국주식 원장잔고확인미국주식 · 계좌	POST	`ust21070`	`/api/us/acnt`
미체결요청국내주식 · 계좌	POST	`ka10075`	`/api/dostk/acnt`
계좌별주문체결내역상세요청국내주식 · 계좌	POST	`kt00007`	`/api/dostk/acnt`
주식체결국내주식 · 실시간시세	WS	`0B`	`/api/websocket`
주식우선호가국내주식 · 실시간시세	WS	`0C`	`/api/websocket`
주식호가잔량국내주식 · 실시간시세	WS	`0D`	`/api/websocket`

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

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

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

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