账户操作
账户类 WebSocket 消息用于辅助展示账户状态和变化。它不能替代 REST 账户摘要接口。
| 用途 | 推荐接口 |
|---|---|
| 程序启动读取账户 | REST /portfolio/accounts、/iserver/accounts |
| 账户资产和保证金 | REST /portfolio/{accountId}/summary |
| 盈亏变化 | WebSocket spl+{} |
| 持仓变化校验 | REST positions + WebSocket 推送 |
为什么要 REST + WebSocket 一起用
Section titled “为什么要 REST + WebSocket 一起用”WebSocket 是变化流,REST 是状态快照。程序启动时没有历史上下文,只靠 WebSocket 可能不知道账户完整状态。
可靠做法:
- 启动时调用 REST 获取账户和持仓。
- 建立 WebSocket 订阅盈亏、订单和成交。
- 断线重连后重新拉 REST 快照。
| 现象 | 说明 |
|---|---|
| WebSocket 没有账户消息 | 没订阅对应 topic,或账户没有变化。 |
| 账户摘要和推送不同步 | 推送有延迟,或字段口径不同。 |
| 多账户显示混乱 | 所有消息都按 accountId 分组处理。 |
页面、日志和错误上报里不要展示真实账户号、账户标题或用户名。需要排查问题时,先做脱敏再保存原始消息。