加密货币交易推送概览

WebSocket 加密货币交易推送用于在连接建立并完成鉴权后，实时接收账户维度的交易事件通知，适合订单状态变更、成交状态变更等对时效性要求较高的场景。

WebSocket Trade 接入地址：

wss://webapi-trade.futunn.com/ws

能力概览

事件类型	说明
EVENT_NEW	下单成功。订单已被系统受理，进入委托队列。
EVENT_NEW_REJECTED	下单失败。订单被系统拒绝（如余额不足、价格非法、风控拦截）。
EVENT_FILL	成交事件。包含部分成交和全部成交。通过 order_info.ord_status 和 order_info.is_close 区分。
EVENT_CANCELED	撤单成功。订单已被全部撤销，进入终态。
EVENT_EXPIRED	订单过期。订单因有效期到期被系统撤销，进入终态。

推送消息的完整字段含义详见 数据格式。

接入流程

步骤	说明
1. 建立连接	连接 WebSocket Trade 地址 wss://webapi-trade.futunn.com/ws。
2. 登录鉴权	连接建立后先完成登录鉴权。推荐使用 OAuth 2.1 + PKCE 获取的 Bearer Token，也兼容传统 API Key 方式。详见 登录鉴权。
3. 接收推送	鉴权成功后即自动订阅当前鉴权用户的所有加密货币交易事件，无需额外发送订阅请求。服务端在交易事件发生时主动推送 Protobuf 二进制消息。详见 订阅机制。
4. 连接保活	定时 refresh token 以维持连接有效性，避免因 token 过期导致连接断开。详见 连接保活。
5. 断线重连	连接断开后，客户端应重新连接并重新登录鉴权。重连成功后会自动恢复事件推送，不要假设断线期间的事件会被补发。

重要约束

• 必须先鉴权：未完成登录鉴权时不会推送任何事件。
• 不保证补发：连接断开期间发生的交易事件不会在重连后补发。如需补齐历史订单或成交数据，请使用 REST 接口查询。
• 长连接需要容错：网络切换、代理超时、服务端维护都可能导致连接断开。客户端应实现断线重连和重新鉴权。
• 事件不保证严格顺序：极少数情况下，网络抖动可能导致事件到达顺序与实际发生顺序不一致，请勿依赖推送顺序作为唯一的状态机驱动。

下一步

• 登录鉴权 — 了解 WebSocket 连接后的登录鉴权流程。
• 订阅机制与场景处理 — 各事件类型的处理场景、终态判断、幂等建议与时序示例。
• 连接保活 — 了解心跳、超时、断线重连等长连接处理建议。
• 数据格式 — 查看推送消息结构、事件类型和字段说明。
• 错误码 — 排查鉴权和连接相关错误。