SuperAPI AI 工具集

bingx-swap-ws-market

数据与分析

查看项目

更新于 10-15 20:06

技能介绍

用途:通过 WebSocket 订阅 BingX USDT-M 永续合约的公开实时行情,无需认证。

主要能力与频道:Depth({symbol}@depth{level}@{interval},有限档深度)、Trade({symbol}@trade,最新成交)、K-Line({symbol}@kline_{interval},OHLCV)、24h Ticker({symbol}@ticker)、Last Price({symbol}@lastPrice)、Mark Price({symbol}@markPrice)、Book Ticker({symbol}@bookTicker,最优买卖价量)、Incremental Depth({symbol}@incrDepth,增量深度)。推送频率:BTC/ETH 深度 200ms、其他 500ms;Book Ticker 每 200ms;Ticker 每 1s;增量深度 BTC/ETH 200ms、其他 800ms。

使用方式:连接 wss://open-api-swap.bingx.com/swap-market,发送 JSON 订阅消息(含 id、reqType:"sub"、dataType)。必须设置 binaryType="arraybuffer" 并用 pako 做 GZIP 解压,收到 "Ping" 时回复 "Pong"。symbol 为 BASE-QUOTE 格式(如 BTC-USDT),需匹配 ^[A-Z0-9]+-[A-Z]+$ 且不超过 20 字符;depth level 取 5/10/20/50/100;depth interval 取 200ms 或 500ms;kline interval 取 1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M。

适用场景:构建行情看板、交易监控、策略数据采集等需要实时公开行情的应用。

限制:仅公开只读行情,不涉及下单或账户操作;参数须按枚举与正则校验,拒绝含 &、=、?、# 或换行的值;连接与解压逻辑须按文档原样使用,不可改为文本模式或省略 GZIP 解压。完整订阅参数与响应字段见 api-reference.md,连接细节见 references/websocket.md。