用途:通过 WebSocket 获取 BingX 现货账户的实时数据,包括订单创建、成交、取消(spot.executionReport)与账户余额变动(ACCOUNT_UPDATE)。与合约账户流不同,现货账户流在连接后需显式发送订阅请求。
主要能力:WebSocket 端点 wss://open-api-ws.bingx.com/market?listenKey=<key>;Listen Key 通过 REST 管理,POST /openApi/user/auth/userDataStream 生成(有效期 1 小时),PUT 续期至 60 分钟(建议每 30 分钟调用一次),DELETE 删除。请求头需 X-BX-APIKEY 与 X-SOURCE-KEY: BX-AI-SKILL,签名使用 HMAC SHA256。
使用方式:先调用 generateListenKey 获取密钥,再用 connectSpotWsAccount 建立连接并订阅频道,如 ["spot.executionReport", "ACCOUNT_UPDATE"]。需处理 GZIP 解压与 Ping/Pong 心跳。资料要求 connectSpotWsAccount、generateListenKey、decompress 三个函数须原样复制,不得重写 WebSocket 或解压逻辑。
适用场景:现货账户实时监控、订单状态跟踪、余额变动通知。
限制:Listen Key 管理涉及 POST/PUT/DELETE 写操作,需用户自行实现;资料中的代理交互规则要求仅执行 GET 请求、不向用户返回代码、参数需校验并拒绝含 &、=、?、# 或换行的值。订阅无需 symbol 参数,可在推送数据中按 data.s 或 a.B[].a 过滤。完整事件字段与响应结构见 api-reference.md,认证细节见 references/authentication.md。