美股全市场快照 · REST 接口

美股全市场快照。一次响应返回整个美股市场的快照，覆盖 10000 多个活跃标的，汇总价格、成交量与成交活动等信息，无需多次查询。快照数据每日美东时间 3:30 清空，随后随交易所上报新数据逐步回填，最早可能从 4:00 开始。

GET /v2/snapshot/locale/us/markets/stocks/tickers

上游时效说明

延迟 15 分钟或实时

上游历史范围

该接口不适用

适用场景

市场总览、批量数据处理、热力图与看板、自动化监控。

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

查询参数

参数	类型	必填	说明
`tickers`	array	No	以逗号分隔的代码列表，区分大小写，用于获取对应的快照。例如 AAPL,TSLA,GOOG。留空则默认查询全部代码。
`include_otc`	boolean	No	是否在响应中包含场外（OTC）证券。默认为 false，即不含 OTC 证券。

响应字段

字段	类型	说明
`count`	integer	本次请求的结果总数。
`status`	string	本次请求响应的状态。
`tickers`	array[object]	指定标的的快照数据数组。
`tickers[].day`	object	该标的最新日线。
`tickers[].fmv`	number	Massive 的公允市场价值由其专有算法计算，提供可交易证券的实时估计公允价。上游仅向 Business 套餐提供；本站能否提供该数据，以实际开通清单为准。
`tickers[].lastQuote`	object	该标的最新报价。仅当当前套餐包含报价数据时才会返回。
`tickers[].lastTrade`	object	该标的最新一笔成交。仅当当前套餐包含成交数据时才会返回。
`tickers[].min`	object	该标的最新分钟线。
`tickers[].prevDay`	object	该标的前一日 K 线。
`tickers[].ticker`	string	该标的在交易所使用的交易代码。
`tickers[].todaysChange`	number	相对前一日的变动值。
`tickers[].todaysChangePerc`	number	相对前一日的涨跌幅。
`tickers[].updated`	integer	最后更新时间戳。

响应示例

{
  "count": 1,
  "status": "OK",
  "tickers": [
    {
      "day": {
        "c": 20.506,
        "dv": "37216.0",
        "h": 20.64,
        "l": 20.506,
        "o": 20.64,
        "v": 37216,
        "vw": 20.616
      },
      "lastQuote": {
        "P": 20.6,
        "S": 22,
        "p": 20.5,
        "s": 13,
        "t": 1605192959994246100
      },
      "lastTrade": {
        "c": [
          14,
          41
        ],
        "ds": "2416.0",
        "i": "71675577320245",
        "p": 20.506,
        "s": 2416,
        "t": 1605192894630916600,
        "x": 4
      },
      "min": {
        "av": 37216,
        "c": 20.506,
        "dav": "37216.0",
        "dv": "5000.0",
        "h": 20.506,
        "l": 20.506,
        "n": 1,
        "o": 20.506,
        "t": 1684428600000,
        "v": 5000,
        "vw": 20.5105
      },
      "prevDay": {
        "c": 20.63,
        "h": 21,
        "l": 20.5,
        "o": 20.79,
        "v": 292738,
        "vw": 20.6939
      },
      "ticker": "BCAT",
      "todaysChange": -0.124,
      "todaysChangePerc": -0.601,
      "updated": 1605192894630916600
    }
  ]
}

原文：Massive 文档 ↗

美股 全市场快照 · REST 接口

适用场景

查询参数

响应字段

响应示例

美股全市场快照 · REST 接口