跳转到主要内容
订阅 balances 频道,以 balance_response 对象接收账户余额快照。系统每 60 秒定期发布快照,并在成交、入金、出金、资金费用、奖励及订单保证金变化后发送额外的事件驱动更新。

更新时机与初始快照

新订阅建立后,网关发送 {"subscribed":"balances"},并立即将根据最新缓存账户状态生成的 balance_response 加入发送队列,无需等到下一次定期刷新。这是缓存快照,不是重新查询的余额;若网关尚未缓存余额,则在更新到达之前发送默认的零值余额。 下单或撤单导致预留订单保证金变化时会触发更新,包括 order_margin 和 available_balance 的变化。预留保证金更新按账户以约一秒的频率合并,其他账户事件可能更早触发快照。系统不保证每笔订单对应一条消息,且消息为异步投递。 60 秒是定期刷新间隔,并非最大投递延迟保证。每条消息均为余额快照,而不是增量。

1. 身份认证

连接 wss://trade.qfex.com?api_key=YOUR_API_KEY 后立即发送:

2. 订阅

示例代码

响应示例

初始、定期及事件驱动快照均使用 balance_response。旧版 balance_update/v4_balances 消息封装不适用于 wss://trade.qfex.com。