跳至主要内容

基本信息

基地址​

生產環境: 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} 信封。