API를 호출할 때마다 토큰을 새로 발급해야 하나요?
발급 응답의 만료 정보와 공식 발급 제한을 확인하고 유효한 토큰을 재사용하는 구조로 설계하세요. 여러 요청이 동시에 만료를 감지해도 재발급이 중복 실행되지 않도록 관리하는 것이 좋습니다.
STOCK API HUB · DEVELOPER GUIDE
증권사 API 접근토큰 발급과 인증 비교
증권사별 접근토큰 발급 API와 인증 흐름을 비교하세요. 발급 환경, 만료 관리, 일반 조회와 웹소켓 인증의 차이를 확인합니다.
OAuth 인증 API를 고르는 기준
접근토큰은 API 호출 권한을 전달하는 인증 수단입니다. 앱키를 발급받은 환경과 토큰을 사용할 환경을 맞추고, 응답의 만료 정보를 기준으로 재발급을 관리해야 합니다.
자주 묻는 개발 질문
토큰은 있는데 인증 오류가 계속 나면 무엇을 확인하나요?
요청 대상 서버와 앱키의 환경, 토큰 만료 여부, 인증 헤더 형식을 차례로 확인하세요. 일반 HTTP 인증과 WebSocket 접속 인증이 별도인지는 각 증권사 명세를 확인해야 합니다. 토큰이나 시크릿은 오류 문의에 첨부하지 마세요.
KB증권 OAuth 인증 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 토큰 발급OAuth 인증 · 인증 | POST | token | /oauth2/token |
LS증권 OAuth 인증 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 접근토큰 발급OAuth 인증 · 접근토큰 발급 | POST | token | /oauth2/token |
키움증권 OAuth 인증 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 접근토큰 발급OAuth 인증 · 접근토큰발급 | POST | au10001 | /oauth2/token |
한국투자증권 OAuth 인증 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 접근토큰발급(P)OAuth인증 · 인증 | POST | 인증-001 | /oauth2/tokenP |
토스증권 OAuth 인증 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| OAuth2 액세스 토큰 발급인증 · 인증 | POST | issueOAuth2Token | /oauth2/token |
DB증권 OAuth 인증 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 접근토큰 발급OAuth 인증 · OAuth 인증 | POST | token | /oauth2/token |
NH투자증권 OAuth 인증 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 접근토큰발급OAuth 인증 · OAuth 인증 | POST | token | /oauth2/token |
구현 전 확인할 점
- 키·시크릿과 발급한 토큰은 공개 게시글이나 클라이언트 소스에 넣지 마세요.
- 토큰 유효기간과 발급 제한을 확인하고 유효한 토큰을 재사용하세요.
- 웹소켓 접속키를 별도로 발급해야 하는지는 해당 증권사의 인증 명세를 확인하세요.
API 이름·카테고리·전송 방식을 기준으로 대표 명세를 분류했습니다. 상품과 권한, 요청 필드는 각 명세에서 다시 확인하세요.
구현 경험과 해결 방법을 함께 나눠요
연결에 성공한 작은 예제도 다른 개발자의 출발점이 됩니다. 사용한 증권사와 API 이름, 구현 목적, 해결 과정을 API 활용 레시피에 남겨 주세요. 오류를 질문할 때는 재현 조건과 오류 코드를 적고 계좌번호·토큰·앱키는 지워 주세요.