토큰 발급은 성공했는데 잔고 조회가 실패하면 어떻게 하나요?
인증 성공과 계좌 조회 입력값 검증은 별개입니다. 계좌번호와 상품코드가 비어 있지 않은지, 앱키·토큰·계좌의 환경이 일치하는지 확인하세요. HTTP 상태뿐 아니라 응답의 업무 오류 코드와 메시지도 읽어야 합니다.
STOCK API HUB · DEVELOPER GUIDE
증권사별 주식 계좌·잔고 API 비교
증권사별 주식 잔고·보유자산 조회 API를 비교하세요. 계좌 구분, 평가금액, 연속조회 조건과 관련 명세를 한곳에서 확인합니다.
계좌·잔고 API를 고르는 기준
잔고 조회는 보유 수량, 매입금액, 평가금액 등 계좌 상태를 확인하는 기능입니다. 주문 가능 금액과 결제 완료 잔고는 같은 값이 아닐 수 있으므로 화면이나 전략에서 사용할 항목의 정의를 먼저 정해야 합니다.
자주 묻는 개발 질문
잔고에서 일부 종목만 조회되는 이유는 무엇인가요?
조회 조건에 상품이나 시장 필터가 있는지 살펴보세요. 연속조회가 제공되는 명세라면 다음 페이지의 키와 종료 조건을 확인하고 모든 응답을 합쳐야 합니다. 계좌와 통화별 값은 분리해서 처리하세요.
KB증권 계좌·잔고 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 보유주식 조회국내주식 · 계좌잔고 | POST | SSQM1801 | /api/v1/ssqm1801 |
| 잔고현황 조회(결제기준)국내주식 · 계좌잔고 | POST | SSQM2932 | /api/v1/ssqm2932 |
| 잔고현황 조회(체결기준)국내주식 · 계좌잔고 | POST | SSQM2952 | /api/v1/ssqm2952 |
LS증권 계좌·잔고 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 주식잔고2주식 · 계좌 | POST | t0424 | /stock/accno |
| 해외주식 종합잔고평가 API해외주식 · 계좌 | POST | COSOQ00201 | /overseas-stock/accno |
키움증권 계좌·잔고 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 계좌평가잔고내역요청국내주식 · 계좌 | POST | kt00018 | /api/dostk/acnt |
| 미국주식 원장잔고확인미국주식 · 계좌 | POST | ust21070 | /api/us/acnt |
한국투자증권 계좌·잔고 API
토스증권 계좌·잔고 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 보유 주식 조회계좌·자산 · 자산 | GET | getHoldings | /api/v1/holdings |
DB증권 계좌·잔고 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 주식잔고조회국내주식주문 · 국내주식주문 | POST | CSPAQ03420 | /api/v1/trading/kr-stock/inquiry/balance |
| 해외주식 잔고/증거금 조회해외주식주문 · 해외주식주문 | POST | CAZCQ00400 | /api/v1/trading/overseas-stock/inquiry/balance-margin |
NH투자증권 계좌·잔고 API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 국내 주식 조회 잔고국내주식 · 조회 · 국내주식 · 조회 | POST | SCIOT983691 | /krstock/inquiry/v1/balance |
| 국내 주식 조회 자산현황국내주식 · 조회 · 국내주식 · 조회 | POST | SCIOT933061 | /krstock/inquiry/v1/assetStatus |
| 국내 주식 조회 권리보유국내주식 · 조회 · 국내주식 · 조회 | POST | SCRITF25012 | /krstock/inquiry/v1/rightsHeld |
구현 전 확인할 점
- 계좌번호와 상품코드, 국내·해외 구분값을 빠짐없이 입력하세요.
- 종목이 많으면 연속조회가 필요할 수 있습니다. 첫 응답만 전체 잔고로 처리하지 마세요.
- 평가 기준과 통화, 결제 반영 시점을 확인하고 응답을 계좌 단위로 분리하세요.
API 이름·카테고리·전송 방식을 기준으로 대표 명세를 분류했습니다. 상품과 권한, 요청 필드는 각 명세에서 다시 확인하세요.
구현 경험과 해결 방법을 함께 나눠요
연결에 성공한 작은 예제도 다른 개발자의 출발점이 됩니다. 사용한 증권사와 API 이름, 구현 목적, 해결 과정을 API 활용 레시피에 남겨 주세요. 오류를 질문할 때는 재현 조건과 오류 코드를 적고 계좌번호·토큰·앱키는 지워 주세요.