跳至主要内容

基本信息

基地址​

生產環境: wss://f-ws.azverse.net/ws/account/futures

生產環境: wss://f-ws.azverse.xyz/ws/account/futures

測試環境: wss://f-ws.az-qa2.xyz/ws/account/futures


Request Headers​

請求頭必須添加壓縮擴展協議。

Sec-Websocket-Extensions:permessage-deflate


協議​

  • 鑑權在握手階段完成(fail-closed)。 在 WebSocket 升級請求上攜帶有效且未過期的登錄 token,三選一:query(?token=<token> 或 ?zToken=<token>)、cookie(token / zToken)、或 Authorization: Bearer <token> 頭。若 token 缺失 / 無效 / 過期,服務端以 HTTP 401 拒絕握手並關閉連接(不返回任何 in-band 錯誤幀)。

  • 用純頻道名訂閱(無 @listenKey 後綴):{"method":"SUBSCRIBE","params":["order"],"id":"test1"};應答爲 {"id":"test1","code":200,"msg":"success"}。

  • 推送幀爲扁平結構,攜帶 ch(頻道名)、data(數據)與服務端毫秒時間戳 ts:{"ch":"order","data":{...},"ts":1731231231000}。

  • 心跳爲純文本 ping -> pong;空閒 60s(無入站幀)後斷開連接。

  • 訂閱成功後會推送用戶相關數據。