交易推送概覽
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 接口查詢。
- 長連接需要容錯：網絡切換、代理超時、服務端維護都可能導致連接斷開。客戶端應實現斷線重連和重新鑑權。
- 事件不保證嚴格順序：極少數情況下，網絡抖動可能導致事件到達順序與實際發生順序不一致，請勿依賴推送順序作為唯一的狀態機驅動。