疑難解答

幣安WebSocket實時資料流怎麼接入?

發佈於 2026-03-23 | 4 分鐘

幣安WebSocket實時資料流的接入方法、可用資料型別、連線管理和常見問題解決,適合需要實時行情資料的開發者。

想獲取幣安的實時行情資料?WebSocket是最好的方式——低延遲、不消耗REST API權重、資料實時推送。

WebSocket基礎

WebSocket是一種雙向通訊協議。和HTTP請求不同,WebSocket建立連線後可以持續接收伺服器推送的資料,不需要你反覆發請求。

在加密貨幣交易中,WebSocket主要用於獲取:

  • 實時價格
  • 實時成交記錄
  • 深度資料(訂單簿)
  • K線資料
  • 賬戶資訊變化

幣安WebSocket端點

註冊幣安後,幣安提供以下WebSocket端點:

公共資料流(不需要API Key)

基礎端點:wss://stream.binance.com:9443/ws/<streamName>

組合端點:wss://stream.binance.com:9443/stream?streams=<stream1>/<stream2>

使用者資料流(需要API Key)

需要先透過REST API建立一個listenKey,然後用這個key連線WebSocket獲取你的賬戶實時資料。

可用的公共資料流

逐筆交易(Trade)

獲取某個交易對的每一筆成交記錄。

  • 流名稱:btcusdt@trade
  • 資料:價格、數量、買賣方向、時間

K線資料(Kline)

獲取實時K線更新。

  • 流名稱:btcusdt@kline_1m(1分鐘K線)
  • 支援多種週期:1m、5m、15m、1h、4h、1d等

深度資料(Depth)

獲取訂單簿變化。

  • 流名稱:btcusdt@depth或btcusdt@depth@100ms
  • 資料:買賣掛單的變化

24小時行情統計

獲取某個或所有交易對的24小時統計資料。

  • 流名稱:btcusdt@ticker或!ticker@arr(所有交易對)

最新價格

獲取某個或所有交易對的最新成交價。

  • 流名稱:btcusdt@miniTicker

使用者資料流

獲取你賬戶的實時資訊:

  1. 透過REST API呼叫POST /api/v3/userDataStream獲取listenKey
  2. 連線WebSocket:wss://stream.binance.com:9443/ws/<listenKey>
  3. 接收實時推送:
    • 賬戶餘額變化
    • 訂單狀態更新
    • 成交通知

注意:listenKey每60分鐘需要續期一次(透過PUT請求),否則連線會斷開。

連線管理要點

心跳機制

  • 每3分鐘傳送一次ping,伺服器會回覆pong
  • 如果超過一定時間沒有收到pong,需要重新連線

斷線重連

網路不穩定時連線可能斷開。你的程式需要實現自動重連邏輯:

  • 檢測到連線斷開
  • 等待短暫時間(1-5秒)
  • 重新建立連線
  • 重新訂閱資料流

訂閱數量限制

  • 單個連線最多200個資料流
  • 需要更多的話,建立多個連線

常見問題

Q:WebSocket資料有延遲嗎? 正常情況下延遲在幾十毫秒到幾百毫秒之間,取決於你的網路到幣安伺服器的距離。

Q:用Python怎麼連線? 可以使用websocket-client或websockets庫。也有現成的Python幣安SDK(如python-binance)封裝了WebSocket功能。

Q:能同時訂閱現貨和合約嗎? 現貨和合約用不同的端點。合約WebSocket端點是wss://fstream.binance.com/ws/<streamName>。

Q:有資料丟失怎麼辦? WebSocket不保證100%不丟資料。在斷線重連後,可以用REST API補充缺失的資料。

如果你還沒安裝APP可以先下載幣安APP。

總結

幣安WebSocket提供豐富的實時資料流,包括行情、深度、K線和使用者資料。接入簡單,延遲低,不消耗REST API權重。注意做好心跳保活和斷線重連。對於需要實時資料的量化交易和資料分析來說,WebSocket是必備工具。

現在就開始使用幣安

透過專屬推薦連結註冊,永久享受交易手續費減免優惠

立即註冊 下載APP