FINGER TRADER

marketDataDocsPage.wsDepth

WebSocket 호가 잔량

인증된 시장 데이터 Socket에서 bid/ask 호가 잔량을 구독합니다. 지원 여부와 호가 단계 수는 브로커 및 시장 설정에 따라 달라집니다.

문서 프레임워크 · 개요

호가 잔량 구독: action 3, msgType 3. 수신 호가 메시지는 msgType 2입니다.

Flutter 앱은 설정된 Finger Trader 시장 소켓을 사용합니다. 인증된 ticket 엔드포인트에서 WebSocket ticket을 받은 뒤 연결하세요. ticket은 세션 자격 증명이므로 공개하거나 재사용하지 마세요.

Finger Trader Socket 서비스에서 POST /ws-api/v1/auth/build-ticket를 Bearer Token과 함께 호출합니다. 앱은 표준 응답의 data 필드에서 ticket을 읽습니다.

{"action":3,"fromUserId":"<SESSION_USER_ID>","timestamp":"<EPOCH_MILLISECONDS>","msgType":3,"msgId":"<UNIQUE_MESSAGE_ID>","content":{"tickerList":["<TICKER>"]}}

시세 메시지에는 marketType, ticker, time, change, percent, volume, number, high, low, ask, bid, open, close, quoteVolume이 포함됩니다. 호가 메시지에는 marketType, ticker, time, ask 가격 단계와 bid 가격 단계가 포함됩니다. 전송 주기와 호가 단계 수는 클라이언트 계약에 명시되지 않았습니다.

2. 운영 Socket 연결 · 호가 잔량 구독: action 3, msgType 3. 수신 호가 메시지는 msgType 2입니다.

Finger Trader Socket 서비스에서 POST /ws-api/v1/auth/build-ticket를 Bearer Token과 함께 호출합니다. 앱은 표준 응답의 data 필드에서 ticket을 읽습니다.

준비되었습니다. 요청 보내기를 누르기 전까지 전송되지 않습니다.

응답이 여기에 표시됩니다.

Access Token은 이 페이지 메모리에만 보관되며 브라우저 저장소나 Finger Trader 웹사이트 서버로 전송되지 않습니다. 요청 버튼을 누른 후 선택한 공식 API 환경으로만 전송됩니다.

아래 값은 Flutter 클라이언트에 정의된 marketType enum이며 브로커가 활성화한 시장 목록이 아닙니다. 실제 지원 범위는 계좌 및 연결 설정에 따라 달라지므로 브로커에 지원 시장 목록을 요청하세요. REST 시장 필터와 과거 데이터 요청에는 해당 코드를 지정하고, WebSocket은 해당 시장에서 브로커가 설정한 ticker를 확인한 뒤 구독합니다. ticker-list로 반환 종목을 확인할 수 있지만 결과가 비어 있다고 미지원으로 단정할 수는 없습니다.