美股报价 · REST 接口

股票历史报价（NBBO）。获取指定股票在给定时间范围内的 NBBO 报价，每条记录包含各时刻的最优买卖价、数量、交易所与时间戳，反映一档报价环境。可用于分析价格变化并评估 NBBO 层面的流动性。

GET /v3/quotes/{stockTicker}

上游时效说明

盘后或实时

上游历史范围

数据可追溯至 2003 年 9 月 10 日

适用场景

历史报价分析、流动性评估、算法回测、交易策略优化。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`stockTicker`	string	Yes	指定区分大小写的标的代码。例如 AAPL 代表苹果公司。
`timestamp`	string	No	按时间戳查询。可传 YYYY-MM-DD 格式的日期或纳秒时间戳。
`timestamp.gte`	string	No	按 timestamp 范围筛选。
`timestamp.gt`	string	No	按 timestamp 范围筛选。
`timestamp.lte`	string	No	按 timestamp 范围筛选。
`timestamp.lt`	string	No	按 timestamp 范围筛选。
`order`	string	No	按 sort 字段对结果排序。
`limit`	integer	No	限制返回结果数量，默认 1000，最大 50000。
`sort`	string	No	用于排序的字段。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	包含所请求数据的数组。
`results[].ask_exchange`	integer	卖价所属交易所的 ID。
`results[].ask_price`	number	卖价（ask）。
`results[].ask_size`	number	按当前卖价可供卖出的股数总计。
`results[].bid_exchange`	integer	买价所属交易所的 ID。
`results[].bid_price`	number	买价（bid）。
`results[].bid_size`	number	按当前买价买方想要买入的股数总计。
`results[].conditions`	array[integer]	成交条件代码列表。
`results[].indicators`	array[integer]	指标代码列表。
`results[].participant_timestamp`	integer	参与者或交易所的纳秒级 Unix 时间戳，即该报价在交易所实际生成的时间。
`results[].sequence_number`	integer	序号表示报价事件发生的先后顺序。这些序号在每个标的代码内递增且唯一，但并不总是连续（例如 1、2、6、9、10、11）。每个交易时段或每日结束时归零。
`results[].sip_timestamp`	integer	SIP 的纳秒级 Unix 时间戳，即 SIP 从产生该报价的交易所收到它的时间。
`results[].tape`	integer	共有 3 个「带」（tape），用于区分标的的上市交易所。接口中以代表字母序号的整数表示，例如 1 = A、2 = B、3 = C。带 A 为 NYSE 上市证券，带 B 为 NYSE ARCA 与 NYSE American，带 C 为 NASDAQ。
`results[].trf_timestamp`	integer	TRF（交易报告设施）的纳秒精度 Unix 时间戳，即交易报告设施收到该报价的时间。
`status`	string	本次请求响应的状态。

响应示例

{
  "next_url": "https://api.massive.com/v3/quotes/AAPL?cursor=YWN0aXZlPXRydWUmZGF0ZT0yMDIxLTA0LTI1JmxpbWl0PTEmb3JkZXI9YXNjJnBhZ2VfbWFya2VyPUElN0M5YWRjMjY0ZTgyM2E1ZjBiOGUyNDc5YmZiOGE1YmYwNDVkYzU0YjgwMDcyMWE2YmI1ZjBjMjQwMjU4MjFmNGZiJnNvcnQ9dGlja2Vy",
  "request_id": "a47d1beb8c11b6ae897ab76cdbbf35a3",
  "results": [
    {
      "ask_exchange": 0,
      "ask_price": 0,
      "ask_size": 0,
      "bid_exchange": 11,
      "bid_price": 102.7,
      "bid_size": 60,
      "conditions": [
        1
      ],
      "participant_timestamp": 1517562000065321200,
      "sequence_number": 2060,
      "sip_timestamp": 1517562000065700400,
      "tape": 3
    },
    {
      "ask_exchange": 0,
      "ask_price": 0,
      "ask_size": 0,
      "bid_exchange": 11,
      "bid_price": 170,
      "bid_size": 2,
      "conditions": [
        1
      ],
      "participant_timestamp": 1517562000065408300,
      "sequence_number": 2061,
      "sip_timestamp": 1517562000065791500,
      "tape": 3
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

美股 报价 · REST 接口

适用场景

查询参数

响应字段

响应示例

美股报价 · REST 接口