跳到主要内容

基本信息

基地址​

生产环境: 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