用途:订阅 BingX USDT-M 永续合约的账户数据 WebSocket 流,实时获取余额变动、持仓变化、订单更新和账户配置变更。
主要能力:连接 wss://open-api-swap.bingx.com/swap-market?listenKey=<key> 后,事件自动推送,无需订阅频道。事件类型包括 ACCOUNT_UPDATE(余额与持仓变动)、ORDER_TRADE_UPDATE(订单创建、成交、状态变化)、ACCOUNT_CONFIG_UPDATE(杠杆/保证金模式变更,连接时全量推送并每 5 秒一次)、listenKeyExpired(Listen Key 过期)。
使用方式:需先用 REST 接口管理 Listen Key。生成:POST /openApi/user/auth/userDataStream,请求头 X-BX-APIKEY 与 X-SOURCE-KEY: BX-AI-SKILL,返回 listenKey,有效期 1 小时。续期:PUT 同路径,参数 listenKey,建议每 30 分钟调用一次。删除:DELETE 同路径,参数 listenKey。连接时需处理 GZIP 解压与 Ping/Pong 心跳,收到 "Ping" 应回复 "Pong"。账户流自动推送所有交易对,无需 symbol 参数,可按推送数据中的 symbol 字段过滤。
适用场景:实时监控合约账户余额、持仓与订单状态,跟踪杠杆和保证金模式变化。
限制:Listen Key 认证必需;生成、续期、删除为写操作,需用户自行实现;本技能仅执行 GET 请求,不向用户返回代码;参数需按文档校验,拒绝含 &、=、?、# 或换行的值。完整事件字段与响应结构见 api-reference.md,认证签名细节见 references/authentication.md。