STOCK API HUB · DEVELOPER GUIDE

NH투자증권 OpenAPI 가이드

NH투자증권 OpenAPI의 OAuth 인증·공통 · 조회·통보 · 실시간 (Websocket)·국내주식 · 주문 명세를 살펴보세요. 현재 포털에서 제공하는 API와 요청 방식, 인증 및 공식 출처를 안내합니다.

NH투자증권 API 카탈로그는 국내외 주식·파생, 장내채권, 금현물의 주문·조회·시세 항목을 구분합니다. 웹소켓 통보와 상품별 실시간 항목도 별도 카테고리로 찾아볼 수 있습니다.

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

NH투자증권 API 한눈에 보기

현재 제공 명세: 220개
인증: 접근토큰발급
허브 테스트 환경: 운영
WebSocket 명세: 카탈로그에서 확인 가능

공식 가이드는 모의투자 환경을 제공하지 않습니다. 유효한 토큰은 만료 전 다시 발급하지 마세요.

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

OAuth 인증
공통 · 조회
통보 · 실시간 (Websocket)
국내주식 · 주문
국내주식 · 조회
국내주식 · 시세
국내주식 · 실시간 (Websocket)
국내파생 · 주문
국내파생 · 조회
국내파생 · 시세
국내파생 · 실시간 (Websocket)
해외주식 · 주문
해외주식 · 조회
해외주식 · 시세
해외주식 · 실시간 (Websocket)
해외파생 · 주문
해외파생 · 조회
해외파생 · 시세
해외파생 · 실시간 (Websocket)
장내채권 · 주문
장내채권 · 조회
장내채권 · 시세
장내채권 · 실시간 (Websocket)
금현물 · 주문
금현물 · 조회
금현물 · 시세
금현물 · 실시간 (Websocket)

처음 연결할 때 확인할 점

통보용 연결과 시세 조회를 구분하고, 세션 종료 명세를 함께 확인하세요. 접근토큰을 불필요하게 재발급하지 않도록 만료 시각을 관리하는 구조가 필요합니다.

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

주요 API와 명세 바로가기

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

API	방식	TR / 업무코드	엔드포인트
접근토큰발급OAuth 인증 · OAuth 인증	POST	`token`	`/oauth2/token`
국내 주식 시세 현재가국내주식 · 시세 · 국내주식 · 시세	POST	`IVOUTKMST04`	`/krstock/quote/v1/currentPrice`
국내 주식 시세 ETF현재가국내주식 · 시세 · 국내주식 · 시세	POST	`IVOETPREQ01`	`/krstock/quote/v1/etfCurrent`
해외 주식 시세 현재가해외주식 · 시세 · 해외주식 · 시세	POST	`g6101`	`/gbstock/quote/v1/current`
국내 주식 주문 현금매수국내주식 · 주문 · 국내주식 · 주문	POST	`SCSOS61803A`	`/krstock/order/v1/cashBuy`
국내 주식 주문 현금매도국내주식 · 주문 · 국내주식 · 주문	POST	`SCSOS61801A`	`/krstock/order/v1/cashSell`
국내 주식 주문 신용매수국내주식 · 주문 · 국내주식 · 주문	POST	`SCSOS61806A`	`/krstock/order/v1/creditBuy`
국내 주식 조회 잔고국내주식 · 조회 · 국내주식 · 조회	POST	`SCIOT983691`	`/krstock/inquiry/v1/balance`
국내 주식 조회 자산현황국내주식 · 조회 · 국내주식 · 조회	POST	`SCIOT933061`	`/krstock/inquiry/v1/assetStatus`
국내 주식 조회 권리보유국내주식 · 조회 · 국내주식 · 조회	POST	`SCRITF25012`	`/krstock/inquiry/v1/rightsHeld`
국내 주식 조회 체결국내주식 · 조회 · 국내주식 · 조회	POST	`SCSOS630261`	`/krstock/inquiry/v1/dailyOrderExecution`
해외 주식 조회 체결해외주식 · 조회 · 해외주식 · 조회	POST	`SCPSO755961`	`/gbstock/inquiry/v1/unexecuted`
국내 주식 실시간 호가(KRX)국내주식 · 실시간 (Websocket) · 국내주식 · 실시간 (Websocket)	WS	`ob`	`/websocket`
국내 주식 실시간 호가(NXT)국내주식 · 실시간 (Websocket) · 국내주식 · 실시간 (Websocket)	WS	`nb`	`/websocket`

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

투자 대시보드

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

주문 상태 관리

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

공식 출처와 데이터 기준

NH투자증권 공식 API 포털

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

다른 증권사와 비교하기

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

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

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