行情推送概览

WebSocket 行情推送用于在连接建立后持续接收实时行情变化，适合报价看板、行情监控、策略触发、成交明细流等对时效性要求较高的场景。

WebSocket Quote 接入地址：

wss://webapi-quote.moomoo.com

能力概览

分类	说明
基础报价	推送标的的最新价、开盘价、最高价、最低价、昨收价、成交量、成交额、证券状态等 Quote 基础报价字段。
买卖盘	推送标的的实时买卖盘摆盘。返回档数与盘口形态由用户行情权限档（LV1/LV2/LV3）与品类共同决定。
逐笔成交	推送成交明细，包含成交时间、序号、买卖方向、价格、成交量、成交额、成交类型等信息。
K 线	推送当前 K 线更新，支持分钟/日/周/月/季/年等周期，具体周期与复权方式以订阅接口和数据格式页说明为准。
经纪队列	部分港股品类可能随买卖盘能力返回经纪席位队列，具体可用性取决于市场、品类和权限。
市场状态	推送市场维度的交易状态信息，例如市场、状态、交易日等。

WebSocket 推送的消息结构、事件类型和字段含义详见 数据格式。

接入流程

步骤	说明
1. 建立连接	连接 WebSocket Quote 地址 wss://webapi-quote.moomoo.com。
2. 登录鉴权	连接建立后先完成登录鉴权。推荐使用 OAuth 2.1 + PKCE 获取的 Bearer Token，也兼容传统 API Key 方式。详见 登录鉴权。
3. 订阅数据	按标的代码和数据类型发起订阅，例如基础报价、买卖盘、逐笔成交、K 线等。详见 订阅与反订阅。
4. 接收推送	服务端在行情变化时通过 WebSocket 返回 JSON 消息。客户端应按 type 区分 QUOTE、ORDER_BOOK、TICKER、KLINE 等消息类型。
5. 连接保活	定时 refresh token 以维持连接有效性，避免因 token 过期导致连接断开。详见 连接保活。
6. 断线重连	连接断开后，客户端应重新连接、重新登录鉴权，并重新订阅所需标的。不要假设断线后订阅状态会自动恢复。

订阅与推送类型

客户端可显式订阅的行情类型通常包括：

• quote — 基础报价，对应推送消息 QUOTE。
• order_book — 买卖盘，对应推送消息 ORDER_BOOK。
• ticker — 逐笔成交，对应推送消息 TICKER。
• kline — 当前 K 线，对应推送消息 KLINE。

服务端也可能基于已订阅的标的和权限推送衍生消息：

• BROKER_QUEUE — 经纪队列，主要与部分港股买卖盘能力相关。
• MARKET_STATE — 市场状态，按市场维度推送，不绑定单一标的。

标的代码

订阅请求面向开发者使用统一的标的代码格式 {market}.{code}，例如 HK.00700、US.AAPL。不同市场、品类和行情权限支持的数据类型可能不同，请以具体接口说明和权限结果为准。

与 REST 实时行情的关系

WebSocket 推送和 REST 实时行情都用于获取实时市场数据，但适用场景不同：

场景	推荐方式
需要持续接收变化	使用 WebSocket 行情推送，订阅后由服务端主动推送。
只需要一次性查询	使用 REST 实时行情接口，例如行情快照、实时报价、买卖盘、当前 K 线、逐笔成交等。
少量标的低频刷新	可使用 REST 轮询，逻辑简单，便于按需获取。
多标的高频更新	优先使用 WebSocket 推送，避免频繁轮询 REST 接口。
连接中断后的补齐	可在重连后使用 REST 查询最新快照，再恢复 WebSocket 订阅。

相关 REST 接口：

• 行情快照 — 批量获取标的的行情快照（实时）。
• 实时报价 — 批量获取标的的实时股票报价（轻量版快照），对齐推送时的 Quote 基础报价。
• 买卖盘 — 获取标的的实时买卖盘摆盘。
• 当前 K 线 — 获取标的当前 K 线数据。
• 逐笔成交 — 获取标的的逐笔成交数据。

重要约束

• 必须先鉴权再订阅：未完成登录鉴权或权限不足时，订阅或推送可能失败。
• 权限影响返回内容：市场权限、品类权限和行情权限档（LV1/LV2/LV3）会影响可订阅的数据类型、买卖盘档数和深度数据可用性。
• 订阅占用配额：订阅标的和数据类型会消耗对应配额。请按需订阅，离开页面或不再使用时及时反订阅。详见 频率与配额。
• 长连接需要容错：网络切换、代理超时、服务端维护都可能导致连接断开。客户端应实现断线重连、重新登录鉴权和重新订阅。
• 不要依赖消息顺序补历史：推送用于实时增量通知。如需拉取某一时点的完整状态或断线期间的最新状态，请结合 REST 实时行情接口查询。
• 字段可能按品类缺省：不适用品类的字段可能缺省、置 0 或为空。解析时请按 数据格式 做兼容处理。

下一步

• 快速开始 — 获取访问凭证并了解 API Host、认证方式和通用约定。
• 登录鉴权 — 了解 WebSocket 连接后的登录鉴权流程。
• 订阅与反订阅 — 了解如何订阅、反订阅和管理订阅状态。
• 连接保活 — 了解心跳、超时、断线重连等长连接处理建议。
• 数据格式 — 查看推送消息结构、消息类型和字段说明。
• 错误码 — 排查鉴权、订阅、权限和配额相关错误。
• 频率与配额 — 了解订阅配额、调用频率和重试建议。