美股单标的快照 · REST 接口

单标的美股快照。汇总指定标的最新成交、报价以及分钟、日线、前一日等聚合数据。快照数据于美东时间 3:30 清空，并随交易所上报新数据逐步更新，最早可能从 4:00 开始。便于紧盯单个标的的实时动态。

GET /v2/snapshot/locale/us/markets/stocks/tickers/{stocksTicker}

上游时效说明

延迟 15 分钟或实时

上游历史范围

该接口不适用

适用场景

定向监控、实时分析、价格预警、投资者关系。

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

查询参数

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

响应字段

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

响应示例

{
  "request_id": "657e430f1ae768891f018e08e03598d8",
  "status": "OK",
  "ticker": {
    "day": {
      "c": 120.4229,
      "dv": "28727868.0",
      "h": 120.53,
      "l": 118.81,
      "o": 119.62,
      "v": 28727868,
      "vw": 119.725
    },
    "lastQuote": {
      "P": 120.47,
      "S": 4,
      "p": 120.46,
      "s": 8,
      "t": 1605195918507251700
    },
    "lastTrade": {
      "c": [
        14,
        41
      ],
      "ds": "236.0",
      "i": "4046",
      "p": 120.47,
      "s": 236,
      "t": 1605195918306274000,
      "x": 10
    },
    "min": {
      "av": 28724441,
      "c": 120.4201,
      "dav": "28724441.0",
      "dv": "270796.0",
      "h": 120.468,
      "l": 120.37,
      "n": 762,
      "o": 120.435,
      "t": 1684428720000,
      "v": 270796,
      "vw": 120.4129
    },
    "prevDay": {
      "c": 119.49,
      "h": 119.63,
      "l": 116.44,
      "o": 117.19,
      "v": 110597265,
      "vw": 118.4998
    },
    "ticker": "AAPL",
    "todaysChange": 0.98,
    "todaysChangePerc": 0.82,
    "updated": 1605195918306274000
  }
}

原文：Massive 文档 ↗

美股 单标的快照 · REST 接口

适用场景

查询参数

响应字段

响应示例

美股单标的快照 · REST 接口