marketDataDocsPage.wsDepth
WebSocket 市場深度
在已驗證的行情 Socket 上訂閱買賣盤深度。深度串流支援情況及回傳檔位取決於經紀商與市場設定。
訂閱深度更新:action 3、msgType 3;收到的深度訊息使用 msgType 2。
Flutter App 使用 Finger Trader 設定的行情 Socket。先以已驗證的 ticket 端點取得 WebSocket ticket,再帶入 ticket 建立連線。Ticket 是工作階段憑證,請勿重複使用或公開。
在 Finger Trader Socket 服務呼叫 POST /ws-api/v1/auth/build-ticket,並附上帳戶 Bearer Token。App 以 JSON 傳送請求,並從標準 API 回應的 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。App 以 JSON 傳送請求,並從標準 API 回應的 data 欄位讀取 ticket。
準備就緒。按下「送出請求」前不會傳送內容。
回應會顯示在這裡。
Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。
以下是 Flutter 用戶端定義的 marketType 列舉值,並非你的券商/交易商已開通市場清單。實際支援範圍由券商/交易商的帳戶及連線設定決定,請向券商/交易商索取支援市場清單。REST 市場篩選及歷史行情請求使用相應代碼;WebSocket 訂閱則先從該市場的券商/交易商商品清單取得 ticker,再訂閱該 ticker。你可用 ticker-list 檢視回傳商品,但空結果本身不足以判定市場不受支援。