美股 最新报价 · REST 接口
股票最新报价(NBBO)。获取指定股票的最新全国最优买卖报价(NBBO),包括最新买卖价、数量、交易所详情与时间戳,便于评估流动性、跟踪价差并做出更明智的判断。
GET /v2/last/nbbo/{stocksTicker}上游时效说明
实时
上游历史范围
该接口不适用
适用场景
- 价格展示、价差分析、市场监控。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
stocksTicker | string | Yes | 指定区分大小写的标的代码。例如 AAPL 代表苹果公司。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | string | 服务器分配的请求 ID。 |
results | object | 不适用 |
results.P | number | 卖价(ask)。 |
results.S | integer | 按当前卖价可供卖出的股数总计。 |
results.T | string | 该标的在交易所使用的交易代码。 |
results.X | integer | 交易所 ID,映射关系可查阅「交易所名录」。 |
results.c | array[integer] | 成交条件代码列表。 |
results.f | integer | TRF(交易报告设施)的纳秒精度 Unix 时间戳,即交易报告设施收到该消息的时间。 |
results.i | array[integer] | 指标代码列表。 |
results.p | number | 买价(bid)。 |
results.q | integer | 序号表示消息事件发生的先后顺序。这些序号在每个标的代码内递增且唯一,但并不总是连续(例如 1、2、6、9、10、11)。 |
results.s | integer | 按当前买价买方想要买入的股数总计。 |
results.t | integer | SIP 的纳秒精度 Unix 时间戳,即 SIP 收到产生该消息的交易所发来此消息的时间。 |
results.x | integer | 交易所 ID,映射关系可查阅「交易所名录」。 |
results.y | integer | 参与者或交易所的纳秒级 Unix 时间戳,即该报价在交易所实际生成的时间。 |
results.z | integer | 共有 3 个「带」(tape),用于区分标的的上市交易所。接口中以代表字母序号的整数表示,例如 1 = A、2 = B、3 = C。带 A 为 NYSE 上市证券,带 B 为 NYSE ARCA 与 NYSE American,带 C 为 NASDAQ。 |
status | string | 本次请求响应的状态。 |
响应示例
{
"request_id": "b84e24636301f19f88e0dfbf9a45ed5c",
"results": {
"P": 127.98,
"S": 7,
"T": "AAPL",
"X": 19,
"p": 127.96,
"q": 83480742,
"s": 1,
"t": 1617827221349730300,
"x": 11,
"y": 1617827221349366000,
"z": 3
},
"status": "OK"
}原文:Massive 文档 ↗