美股 报价 · WebSocket
股票报价(WebSocket)。实时推送股票的全国最优买卖报价(NBBO),每条消息给出当前最优买卖价、数量与相关元数据,便于跟踪市场变化并驱动实时应用。
WS /stocks/Q上游时效说明
实时
上游历史范围
不适用于 WebSocket 通道
适用场景
- 实时监控、市场分析、交易决策支持、界面动态更新。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
ticker | string | Yes | 指定一个股票代码,或用 * 订阅全部股票。也可用逗号分隔的列表订阅多个代码。可用代码可在「全部标的」接口中获取。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
ev | enum: Q | 事件类型。 |
sym | string | 该股票的代码。 |
bx | integer | 买价交易所 ID。无买价时可省略(见 bp)。 |
bp | number | 买价。无买价(单边或空市场)时与 bs 一并省略。这种情况在美东时间凌晨 4:00 盘前开盘前后最常见,但任何时候都可能发生。 |
bs | integer | 买量。表示买方在给定买价上竞买的股份数量。无买价时省略(见 bp)。 |
ax | integer | 卖价交易所 ID。无卖价时可省略(见 ap)。 |
ap | number | 卖价。无卖价(单边或空市场)时与 as 一并省略。这种情况在美东时间凌晨 4:00 盘前开盘前后最常见,但任何时候都可能发生。 |
as | integer | 卖量。表示卖方在给定卖价上挂出的股份数量。无卖价时省略(见 ap)。 |
c | integer | 条件。 |
i | array[integer] | 指示符。更多信息见「条件与指示符」术语表。 |
t | integer | SIP 时间戳,单位为 Unix 毫秒。 |
pt | integer | 参与者时间戳。报价在交易所生成的时间,为毫秒级 epoch 时间戳。由于 SIP 处理延迟,通常 ≤ t(SIP 时间戳)。由 SIP 生成的报价(条件 82)会省略该字段,因其没有发起方交易所参与者。 |
q | integer | 序号表示报价事件发生的先后顺序。这些序号在每个标的代码内递增且唯一,但并不总是连续(例如 1、2、6、9、10、11)。每个交易时段或每日结束时归零。 |
z | integer | 交易带(tape):1 = NYSE,2 = AMEX,3 = Nasdaq。 |
响应示例
{
"ev": "Q",
"sym": "MSFT",
"bx": 4,
"bp": 114.125,
"bs": 100,
"ax": 7,
"ap": 114.128,
"as": 160,
"c": 0,
"i": [
604
],
"t": 1536036818784,
"pt": 1536036818783,
"q": 50385480,
"z": 3
}原文:Massive 文档 ↗