基本信息
基地址
生产环境: wss://f-ws.azverse.net/futures/public
生产环境: wss://f-ws.azverse.xyz/futures/public
测试环境: wss://f-ws.az-qa2.xyz/futures/public
协议
-
订阅:
{"method":"subscribe","params":["ticker@btc_usdt"],"id":<n>};成功应答{"id":<n>,"code":200,"msg":"success"},失败应答{"id":<n>,"code":400,"msg":"<token>"}(被限流时返回429/rate_limited)。 -
每个推送帧都是统一信封
{ch, event, data}:ch为频道族名(分发键——同一ch⇒ 同一data结构),event为归一后的订阅串(据此对回你的订阅),data为载荷(单 symbol 频道为对象,批量频道如tickers为数组)。只包含非 null 字段。 -
心跳:文本
ping-> 文本pong,或 JSON{"method":"ping"}->{"pong":<ts>};空闲超时断连。 -
频道内 symbol 用小写下划线,如
btc_usdt。 -
全深度采用订阅即下发快照 + 增量(服务端在重启 / 客户端落后时主动重发快照);无需 REST 拉快照。全深度族
ch为depth_update;定档深度(depth5|depth10|depth20|depth50|depth100)使用族chdepth。 -
合约专属:
ticker帧带ix/mx(指数 / 标记价);提供独立fundrate@<symbol>频道;index_price@<symbol>/mark_price@<symbol>为独立频道(族chindex_price/mark_price),严格每秒下发——它们与其它频道一样使用统一{ch, event, data}信封。