WebSocket이 재연결되면 기존 구독도 유지되나요?
재연결 후 인증과 구독을 다시 수행해야 하는지는 해당 명세에 따릅니다. 연결마다 구독 상태를 추적하고 재구독이 중복되지 않게 구현하세요. 연결이 끊긴 동안 놓친 계좌 상태는 조회 API로 대조하세요.
STOCK API HUB · DEVELOPER GUIDE
증권사 WebSocket 연결과 구독 명세 비교
증권사별 WebSocket 명세와 실시간 수신 구조를 살펴보세요. 인증, 구독, 연결 유지, 재접속 시 확인할 사항을 안내합니다.
WebSocket API를 고르는 기준
WebSocket은 연결을 유지하며 서버가 보내는 메시지를 수신하는 전송 방식입니다. 실시간 시세뿐 아니라 주문 통보나 조건검색에도 쓰일 수 있습니다. 일반 HTTP API의 토큰과 웹소켓 인증 정보가 같은지부터 확인해야 합니다.
자주 묻는 개발 질문
WebSocket과 REST를 함께 사용해야 하나요?
실시간 이벤트와 상태 조회는 서로 다른 역할을 합니다. 초기 화면 구성이나 연결 복구 시에는 조회 API를 활용하고, 이후 갱신은 구독 메시지로 반영하는 구성을 검토할 수 있습니다.
KB증권 WebSocket API
이 주제는 전체 API 카탈로그에서 관련 명세를 검색하고 공식 안내와 함께 확인하세요. 아래 링크에서 인증 명세를 시작으로 요청 방식과 지원 범위를 살펴볼 수 있습니다.
LS증권 WebSocket API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 업종별투자자별매매현황업종 · 실시간 시세 | WS | BM_ | /websocket/indtp |
| ETF호가잔량주식 · 실시간 시세 | WS | B7_ | /websocket/stock |
| KOSPI시간외단일가호가잔량주식 · 실시간 시세 | WS | DH1 | /websocket/stock |
키움증권 WebSocket API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 조건검색 목록조회국내주식 · 조건검색 | WS | ka10171 | /api/websocket |
| 조건검색 요청 일반국내주식 · 조건검색 | WS | ka10172 | /api/websocket |
| 조건검색 요청 실시간국내주식 · 조건검색 | WS | ka10173 | /api/websocket |
한국투자증권 WebSocket API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 회원사 실시간 매매동향(틱)국내주식 · 시세분석 | WS | FHPST04320000 | /uapi/domestic-stock/v1/quotations/frgnmem-trade-trend |
| 국내지수 실시간예상체결국내주식 · 실시간시세 | WS | H0UPANC0 | /tryitout/H0UPANC0 |
| 국내주식 장운영정보 (통합)국내주식 · 실시간시세 | WS | H0UNMKO0 | /tryitout/H0UNMKO0 |
토스증권 WebSocket API
이 주제는 전체 API 카탈로그에서 관련 명세를 검색하고 공식 안내와 함께 확인하세요. 아래 링크에서 인증 명세를 시작으로 요청 방식과 지원 범위를 살펴볼 수 있습니다.
DB증권 WebSocket API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| [실시간]주식주문체결 조회국내주식시세(실시간) · 국내주식시세(실시간) | WS | IS1 | /websocket |
| [실시간]주식주문접수 조회국내주식시세(실시간) · 국내주식시세(실시간) | WS | IS0 | /websocket |
| [실시간]주식호가국내주식시세(실시간) · 국내주식시세(실시간) | WS | S01 | /websocket |
NH투자증권 WebSocket API
| API | 방식 | TR / 업무코드 | 엔드포인트 |
|---|---|---|---|
| 체결통보(국내주식/파생)통보 · 실시간 (Websocket) · 통보 · 실시간 (Websocket) | WS | d2 | /websocket |
| 체결통보(국내야간파생)통보 · 실시간 (Websocket) · 통보 · 실시간 (Websocket) | WS | dv | /websocket |
| 체결통보(해외주식)통보 · 실시간 (Websocket) · 통보 · 실시간 (Websocket) | WS | d0 | /websocket |
구현 전 확인할 점
- 연결 주소와 인증 메시지, 구독·해제 메시지 형식을 각각 확인하세요.
- PING/PONG과 재접속 간격을 구현하고 구독 상태를 다시 동기화하세요.
- 토큰·접속키를 공개 코드에 넣지 말고 서버와 브라우저의 역할을 구분하세요.
API 이름·카테고리·전송 방식을 기준으로 대표 명세를 분류했습니다. 상품과 권한, 요청 필드는 각 명세에서 다시 확인하세요.
구현 경험과 해결 방법을 함께 나눠요
연결에 성공한 작은 예제도 다른 개발자의 출발점이 됩니다. 사용한 증권사와 API 이름, 구현 목적, 해결 과정을 API 활용 레시피에 남겨 주세요. 오류를 질문할 때는 재현 조건과 오류 코드를 적고 계좌번호·토큰·앱키는 지워 주세요.