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 を付与します。ticket は標準 API レスポンスの data フィールドから取得します。

{"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 を付与します。ticket は標準 API レスポンスの data フィールドから取得します。

準備完了です。送信ボタンを押すまで送信されません。

応答がここに表示されます。

Access Token はページのメモリ内にのみ保持され、ブラウザーストレージや Finger Trader ウェブサイトサーバーには送信されません。送信ボタンを押した後、選択した公式 API 環境にのみ送信されます。

以下は Flutter クライアントで定義された marketType の enum 値であり、ブローカーが有効化している市場一覧ではありません。実際の提供範囲は口座と接続設定によって異なるため、ブローカーに対応市場一覧を確認してください。REST の市場フィルターや過去データのリクエストには該当コードを指定します。WebSocket では、その市場のブローカー設定済み銘柄から ticker を確認して購読します。ticker-list で銘柄を確認できますが、結果が空でも非対応とは限りません。