基本信息
基地址
生產環境: 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(無入站幀)後斷開連接。 -
訂閱成功後會推送用戶相關數據。