交易推送概览
WebSocket 交易推送用于在连接建立并完成鉴权后，实时接收账户维度的交易事件通知，适合订单状态变更、成交状态变更等对时效性要求较高的场景。
WebSocket Trade 接入地址：
text
wss://webapi-trade.moomoo.com能力概览
| 事件类型 | 说明 |
|---|---|
EVENT_NEW | 下单成功。订单已被交易所或系统受理。 |
EVENT_REPLACED | 改单成功。订单价格或数量已按请求修改。 |
EVENT_CANCELED | 撤单成功。订单已被全部撤销。 |
EVENT_EXPIRED | 订单过期。订单因有效期到期被系统撤销。 |
EVENT_FILL | 成交事件。包含全部成交和部分成交两种情况。 |
EVENT_NEW_REJECTED | 下单失败。订单被交易所或系统拒绝。 |
EVENT_REPLACE_REJECTED | 改单失败。改单请求被拒绝，原订单不变。 |
EVENT_CANCEL_REJECTED | 撤单失败。撤单请求被拒绝，原订单不变。 |
EVENT_FILL_CORRECT | 成交修正。已有成交信息被更正。 |
EVENT_FILL_CANCEL | 成交撤销。已有成交被系统撤销。 |
推送消息的完整字段含义详见 数据格式。
接入流程
| 步骤 | 说明 |
|---|---|
| 1. 建立连接 | 连接 WebSocket Trade 地址 wss://webapi-trade.moomoo.com。 |
| 2. 登录鉴权 | 连接建立后先完成登录鉴权。推荐使用 OAuth 2.1 + PKCE 获取的 Bearer Token，也兼容传统 API Key 方式。详见 登录鉴权。 |
| 3. 接收推送 | 鉴权成功后即自动订阅当前鉴权用户的所有交易事件，无需额外发送订阅请求。服务端在交易事件发生时主动推送 JSON 消息。详见 订阅机制。 |
| 4. 连接保活 | 定时 refresh token 以维持连接有效性，避免因 token 过期导致连接断开。详见 连接保活。 |
| 5. 断线重连 | 连接断开后，客户端应重新连接并重新登录鉴权。重连成功后会自动恢复事件推送，不要假设断线期间的事件会被补发。 |
重要约束
- 必须先鉴权：未完成登录鉴权时不会推送任何事件。
- 不保证补发：连接断开期间发生的交易事件不会在重连后补发。如需补齐历史订单或成交数据，请使用 REST 接口查询。
- 长连接需要容错：网络切换、代理超时、服务端维护都可能导致连接断开。客户端应实现断线重连和重新鉴权。
- 事件不保证严格顺序：极少数情况下，网络抖动可能导致事件到达顺序与实际发生顺序不一致，请勿依赖推送顺序作为唯一的状态机驱动。