用途:订阅 BingX Coin-M(币本位/反向)永续合约的 WebSocket 账户数据流,实时接收账户余额、持仓、订单状态及杠杆/保证金模式变更。
主要能力:连接 wss://open-api-cswap-ws.bingx.com/market?listenKey=<key> 后,事件自动推送,无需频道订阅。事件类型包括 ACCOUNT_UPDATE(余额与持仓变化)、ORDER_TRADE_UPDATE(下单、成交、状态变化)、ACCOUNT_CONFIG_UPDATE(杠杆/保证金模式变化)和 listenKeyExpired(监听密钥过期)。币本位交易对使用 BTC-USD 格式,而非 BTC-USDT。
使用方式:先通过 REST 接口管理 Listen Key——POST /openApi/user/auth/userDataStream 生成(有效期 1 小时),PUT 延长至 60 分钟(建议每 30 分钟调用一次),DELETE 删除;请求头需 X-BX-APIKEY 与 X-SOURCE-KEY: BX-AI-SKILL,签名采用 HMAC SHA256。连接后需处理 GZIP 解压与 Ping/Pong 心跳。账户流自动推送所有交易对,无需 symbol 参数,可按推送数据中的 symbol 字段过滤。
限制:需有效 Listen Key 认证;密钥过期需重新生成并重连;资料未提供完整事件字段与响应结构(见 api-reference.md)。