交易機器人

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

發布於 2026-03-07 | 3 分鐘

介紹幣安WebSocket API的接入方法和常用資料流型別。

如果你在做量化交易或行情監控,WebSocket是獲取幣安實時資料的最佳方式。相比REST API輪詢,WebSocket延遲更低、效率更高。

使用幣安API需要先有賬號,透過 註冊幣安 註冊。手機端管理也很方便,可以 下載幣安APP。

WebSocket基礎地址

幣安現貨WebSocket的基礎地址是 wss://stream.binance.com:9443/ws/,合約的基礎地址略有不同。連線時在地址後面拼接你要訂閱的資料流名稱即可。

也可以使用組合流地址同時訂閱多個資料流:wss://stream.binance.com:9443/stream?streams=流名稱1/流名稱2。

常用資料流型別

逐筆成交(Trade):實時推送每一筆成交記錄,包括價格、數量和時間。流名稱格式:btcusdt@trade。

K線資料(Kline):實時推送K線更新。流名稱格式:btcusdt@kline_1m(1分鐘K線)。支援多種時間週期。

深度資料(Depth):實時推送買賣盤口變化。流名稱格式:btcusdt@depth 或 btcusdt@depth@100ms(100毫秒更新頻率)。

24小時行情(Ticker):推送24小時內的價格變動和成交量統計。流名稱格式:btcusdt@ticker。

接入步驟

第一步:選擇一個WebSocket客戶端庫。Python可以用websocket-client或websockets,JavaScript可以用ws。

第二步:建立連線。連線到幣安WebSocket地址,帶上你要訂閱的流名稱。

第三步:處理訊息。連線建立後,幣安會持續推送JSON格式的資料,你的程式解析並處理這些資料即可。

第四步:心跳保活。WebSocket連線每24小時會斷開,你的程式需要能自動重連。建議每隔幾分鐘傳送一個pong幀保持連線。

注意事項

單個連線最多訂閱200個流。如果需要更多,可以建立多個連線。

WebSocket連線不需要API Key(公開資料流),但使用者資料流(比如訂單更新、賬戶變動)需要先透過REST API獲取一個listenKey。

網路不穩定時連線可能斷開,務必在程式碼中實現自動重連邏輯。

使用者資料流

如果你需要實時獲取自己的訂單狀態和賬戶餘額變化,需要訂閱使用者資料流。先呼叫REST API的POST /api/v3/userDataStream獲取listenKey,然後用這個key連線WebSocket。listenKey每60分鐘需要續期一次。