FINGER TRADER

marketDataDocsPage.wsQuotes

WebSocket 即時報價

使用已驗證的行情 Socket 訂閱報價更新。先選擇某市場的商品,再以 ticker 識別碼訂閱。

文檔架構 · 概覽

透過 WebSocket 接收即時報價與市場深度

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。

POST https://prod-api.fingertrader.com/finger-bff-socket/ws-api/v1/auth/build-ticket
Authorization: Bearer <ACCESS_TOKEN>

wss://prod-api.fingertrader.com/finger-bff-socket/ws?ticket=<WS_TICKET>

2. 連線至正式環境 Socket · 訂閱報價更新:action 3、msgType 1;收到的報價訊息使用 msgType 0。

在 Finger Trader Socket 服務呼叫 POST /ws-api/v1/auth/build-ticket,並附上帳戶 Bearer Token。App 以 JSON 傳送請求,並從標準 API 回應的 data 欄位讀取 ticket。

準備就緒。按下「送出請求」前不會傳送內容。

回應會顯示在這裡。

Access Token 只保留在此頁面的記憶體中,不會寫入瀏覽器儲存空間,也不會傳送至 Finger Trader 官網伺服器。只有按下「送出請求」後,才會傳至你選擇的官方 API 環境;完成後請清除。

訂閱報價更新:action 3、msgType 1;收到的報價訊息使用 msgType 0。

{"action":3,"fromUserId":"<SESSION_USER_ID>","timestamp":"<EPOCH_MILLISECONDS>","msgType":1,"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 價位。用戶端合約沒有指定推送頻率或深度檔數。

以下是 Flutter 用戶端定義的 marketType 列舉值,並非你的券商/交易商已開通市場清單。實際支援範圍由券商/交易商的帳戶及連線設定決定,請向券商/交易商索取支援市場清單。REST 市場篩選及歷史行情請求使用相應代碼;WebSocket 訂閱則先從該市場的券商/交易商商品清單取得 ticker,再訂閱該 ticker。你可用 ticker-list 檢視回傳商品,但空結果本身不足以判定市場不受支援。