如果你在做量化交易或行情監控,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分鐘需要續期一次。