REST 接口 · 文档目录

美股 最新报价 · REST 接口

股票最新报价(NBBO)。获取指定股票的最新全国最优买卖报价(NBBO),包括最新买卖价、数量、交易所详情与时间戳,便于评估流动性、跟踪价差并做出更明智的判断。

GET /v2/last/nbbo/{stocksTicker}
上游时效说明

实时

上游历史范围

该接口不适用

适用场景

  • 价格展示、价差分析、市场监控。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
stocksTickerstringYes指定区分大小写的标的代码。例如 AAPL 代表苹果公司。

响应字段

字段类型说明
request_idstring服务器分配的请求 ID。
resultsobject不适用
results.Pnumber卖价(ask)。
results.Sinteger按当前卖价可供卖出的股数总计。
results.Tstring该标的在交易所使用的交易代码。
results.Xinteger交易所 ID,映射关系可查阅「交易所名录」。
results.carray[integer]成交条件代码列表。
results.fintegerTRF(交易报告设施)的纳秒精度 Unix 时间戳,即交易报告设施收到该消息的时间。
results.iarray[integer]指标代码列表。
results.pnumber买价(bid)。
results.qinteger序号表示消息事件发生的先后顺序。这些序号在每个标的代码内递增且唯一,但并不总是连续(例如 1、2、6、9、10、11)。
results.sinteger按当前买价买方想要买入的股数总计。
results.tintegerSIP 的纳秒精度 Unix 时间戳,即 SIP 收到产生该消息的交易所发来此消息的时间。
results.xinteger交易所 ID,映射关系可查阅「交易所名录」。
results.yinteger参与者或交易所的纳秒级 Unix 时间戳,即该报价在交易所实际生成的时间。
results.zinteger共有 3 个「带」(tape),用于区分标的的上市交易所。接口中以代表字母序号的整数表示,例如 1 = A、2 = B、3 = C。带 A 为 NYSE 上市证券,带 B 为 NYSE ARCA 与 NYSE American,带 C 为 NASDAQ。
statusstring本次请求响应的状态。

响应示例

{
  "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 文档 ↗