跳到主要内容

基本信息

基地址​

生产环境: 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)使用族 ch depth。

  • 合约专属:ticker 帧带 ix/mx(指数 / 标记价);提供独立 fundrate@<symbol> 频道;index_price@<symbol> / mark_price@<symbol> 为独立频道(族 ch index_price / mark_price),严格每秒下发——它们与其它频道一样使用统一 {ch, event, data} 信封。