メインコンテンツへスキップ

概要

WebSocketエンドポイントは、リアルタイムデータストリーミングおよびChainStreamエクスチェンジでのHTTPリクエスト送信の代替手段として利用できます。ネットワーク別のWebSocket URLは以下の通りです:
  • メインネット: wss://realtime-dex.chainstream.io/connection/websocket

認証

WebSocket接続は、URL内のtokenクエリパラメータによる認証が必要です:
wss://realtime-dex.chainstream.io/connection/websocket?token=YOUR_ACCESS_TOKEN
Go SDKまたはJavaScript SDKを使用している場合、認証は組み込みで自動的に処理されます。ネイティブWebSocketライブラリやその他のサードパーティライブラリを使用する場合にのみ、手動でtokenパラメータを追加する必要があります。

接続

WebSocket APIに接続するには、希望するネットワークに基づいて対応するURLにWebSocket接続を確立し、URLにtokenパラメータを含める必要があります。接続が確立されると、サブスクリプションメッセージの送信を開始してリアルタイムデータの更新を受信できます。

コマンドライン例

wscatを使用して接続をテストする場合:
$ wscat -c "wss://realtime-dex.chainstream.io/connection/websocket?token=YOUR_ACCESS_TOKEN"
Connected (press CTRL+C to quit)
> { "method": "subscribe", "subscription": { "type": "trades", "coin": "SOL" } }
< {"channel":"subscriptionResponse","data":{"method":"subscribe","subscription":{"type":"trades","coin":"SOL"}}}
有効なtokenパラメータを提供しない場合、接続が拒否されるか、データを受信できなくなります。
このドキュメントでは、メッセージタイプの定義にTypeScriptを使用しています。Pythonユーザーの場合は、Python SDKで同等の型を見つけることができます。