marketDataDocsPage.wsQuotes
WebSocket リアルタイム気配値
認証済みマーケットデータ Socket で気配値更新を購読します。市場の商品を選び、ticker 識別子を使って購読してください。
WebSocket によるリアルタイム気配値・板情報
Flutter アプリは設定済みの Finger Trader マーケットソケットを使用します。認証済み ticket エンドポイントから WebSocket ticket を取得して接続します。ticket はセッション資格情報のため公開しないでください。
Finger Trader Socket サービスで POST /ws-api/v1/auth/build-ticket を呼び出し、Bearer Token を付与します。ticket は標準 API レスポンスの data フィールドから取得します。
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 を付与します。ticket は標準 API レスポンスの data フィールドから取得します。
準備完了です。送信ボタンを押すまで送信されません。
応答がここに表示されます。
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 の enum 値であり、ブローカーが有効化している市場一覧ではありません。実際の提供範囲は口座と接続設定によって異なるため、ブローカーに対応市場一覧を確認してください。REST の市場フィルターや過去データのリクエストには該当コードを指定します。WebSocket では、その市場のブローカー設定済み銘柄から ticker を確認して購読します。ticker-list で銘柄を確認できますが、結果が空でも非対応とは限りません。