跳至主要内容

基本信息

基地址​

生產環境: wss://s-ws.azverse.net/ws/account/spot

生產環境: wss://s-ws.azverse.xyz/ws/account/spot

測試環境: wss://s-ws.az-qa2.xyz/ws/account/spot


協議​

  • token 在握手時攜帶(不再有 LOGIN 報文)。從 /az/spot/ws-token 獲取後,通過查詢串 ?token=<accessToken>(或 ?zToken=)、或 token / zToken cookie、或 Authorization: Bearer <accessToken> 請求頭傳入。

  • 鑑權爲 fail-closed:token 缺失/無效/過期,或路徑錯誤,直接返回 HTTP 401 並關閉連接。

  • 賬戶由 token 解析得到——訂閱頻道名不帶 @accountId 後綴。

  • 訂閱:{"method":"subscribe","params":["balance","order"],"id":<n>};應答成功爲 {"id":<n>,"code":200,"msg":"success"},失敗爲 {"id":<n>,"code":400,"msg":"<原因>"}。

  • 推送幀爲扁平結構,帶 ch:{"ch":"balance","data":{...},"ts":<ts>}。

  • 頻道:balance、order、trade、entrust、pred_position(現貨專有)。訂閱現貨域外的頻道返回 400。

  • 心跳爲文本 ping -> pong。連接在讀空閒 60s 後斷開。

Request Headers​

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

Sec-Websocket-Extensions:permessage-deflate