STOCK API HUB · DEVELOPER GUIDE

한국투자증권 OpenAPI(KIS) 가이드

한국투자증권 OpenAPI(KIS)의 OAuth인증·국내주식·국내선물옵션·해외주식 명세를 살펴보세요. 현재 포털에서 제공하는 API와 요청 방식, 인증 및 공식 출처를 안내합니다.

한국투자증권 KIS OpenAPI는 현재 카탈로그에서 국내주식·해외주식 외에 선물옵션과 장내채권 명세도 찾아볼 수 있습니다. 접근토큰 발급과 웹소켓 접속키 발급은 별도 항목이므로, 일반 조회와 실시간 구독에 필요한 인증을 구분해서 확인하세요.

한국투자증권 API 전체 명세 보기 공식 API 포털

한국투자증권 API 한눈에 보기

현재 제공 명세: 338개
인증: 접근토큰발급(P)
허브 테스트 환경: 운영 / 모의투자
WebSocket 명세: 카탈로그에서 확인 가능

개인 고객 인증을 사용합니다. 모의투자 지원 여부와 tr_id는 개별 API 명세를 확인하세요.

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

OAuth인증
국내주식
국내선물옵션
해외주식
해외선물옵션
장내채권

처음 연결할 때 확인할 점

계좌 조회에는 계좌번호와 계좌상품코드가 필요합니다. 운영·모의투자 환경에 맞는 TR ID와 필수 조회 조건을 명세에서 확인한 뒤 요청하세요.

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

주요 API와 명세 바로가기

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

API	방식	TR / 업무코드	엔드포인트
접근토큰발급(P)OAuth인증 · 인증	POST	`인증-001`	`/oauth2/tokenP`
주식현재가 시세국내주식 · 기본시세	GET	`FHKST01010100`	`/uapi/domestic-stock/v1/quotations/inquire-price`
주식현재가 당일시간대별체결국내주식 · 기본시세	GET	`FHPST01060000`	`/uapi/domestic-stock/v1/quotations/inquire-time-itemconclusion`
주식현재가 시세2국내주식 · 기본시세	GET	`FHPST01010000`	`/uapi/domestic-stock/v1/quotations/inquire-price-2`
주식주문(정정취소)국내주식 · 주문/계좌	POST	`TTTC0013U`	`/uapi/domestic-stock/v1/trading/order-rvsecncl`
주식주문(현금)국내주식 · 주문/계좌	POST	`(매도) TTTC0011U (매수) TTTC0012U`	`/uapi/domestic-stock/v1/trading/order-cash`
주식주문(신용)국내주식 · 주문/계좌	POST	`(매도) TTTC0051U (매수) TTTC0052U`	`/uapi/domestic-stock/v1/trading/order-credit`
주식잔고조회국내주식 · 주문/계좌	GET	`TTTC8434R`	`/uapi/domestic-stock/v1/trading/inquire-balance`
해외주식 잔고해외주식 · 주문/계좌	GET	`TTTS3012R`	`/uapi/overseas-stock/v1/trading/inquire-balance`
주식일별주문체결조회국내주식 · 주문/계좌	GET	`(3개월이내) TTTC0081R (3개월이전) CTSC9215R`	`/uapi/domestic-stock/v1/trading/inquire-daily-ccld`
해외주식 미체결내역해외주식 · 주문/계좌	GET	`TTTS3018R`	`/uapi/overseas-stock/v1/trading/inquire-nccs`
국내주식 시간외 실시간예상체결 (KRX)국내주식 · 실시간시세	WS	`H0STOAC0`	`/tryitout/H0STOAC0`
국내주식 시간외 실시간호가 (KRX)국내주식 · 실시간시세	WS	`H0STOAA0`	`/tryitout/H0STOAA0`
국내주식 실시간호가 (통합)국내주식 · 실시간시세	WS	`H0UNASP0`	`/tryitout/H0UNASP0`

한국투자증권 API로 구성할 수 있는 개발 흐름

투자 대시보드

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

주문 상태 관리

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

공식 출처와 데이터 기준

한국투자증권 공식 API 포털 · 공식 가이드 / 공개 예제

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

다른 증권사와 비교하기

구현 경험과 해결 방법을 함께 나눠요

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

API 활용 레시피에서 질문·경험 나누기