美股自定义 K 线（OHLC） · REST 接口

股票自定义 K 线聚合。按自定义日期范围与时间粒度（美东时区）获取指定股票的聚合开盘价、最高价、最低价、收盘价与成交量数据。聚合仅基于满足条件的有效成交生成；某时间窗内若无有效成交，则不产生 K 线。可通过 multiplier 与 timespan 参数调整粒度，例如 5 分钟 K 线；支持盘前、常规与盘后时段。

GET /v2/aggs/ticker/{stocksTicker}/range/{multiplier}/{timespan}/{from}/{to}

上游时效说明

盘后、延迟 15 分钟或实时

上游历史范围

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

适用场景

数据可视化、技术分析、策略回测、市场研究。

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

查询参数

参数	类型	必填	说明
`stocksTicker`	string	Yes	指定区分大小写的标的代码。例如 AAPL 代表苹果公司。
`multiplier`	integer	Yes	时间跨度倍数的取值。
`timespan`	string	Yes	时间窗口的长度。
`from`	string	Yes	聚合时间窗口的起点，可为 YYYY-MM-DD 格式的日期或毫秒时间戳。
`to`	string	Yes	聚合时间窗口的终点，可为 YYYY-MM-DD 格式的日期或毫秒时间戳。
`adjusted`	boolean	No	结果是否按拆合股复权。默认已复权；设为 false 可获取未复权的结果。
`sort`	N/A	No	按时间戳排序结果。asc 为升序（最早的在前），desc 为降序（最新的在前）。
`limit`	integer	No	限制为生成聚合结果而查询的底层聚合条数，最大 50000，默认 5000。

响应字段

字段	类型	说明
`ticker`	string	该标的在交易所使用的交易代码。
`adjusted`	boolean	该响应是否为按拆合股复权后的数据。
`queryCount`	integer	生成该响应所用的聚合条数（分钟或日线）。
`request_id`	string	服务器分配的请求 ID。
`resultsCount`	integer	本次请求的结果总数。
`status`	string	本次请求响应的状态。
`results`	array[object]	包含所请求数据的数组。
`results[].c`	number	该标的在给定时间段内的收盘价。
`results[].h`	number	该标的在给定时间段内的最高价。
`results[].l`	number	该标的在给定时间段内的最低价。
`results[].n`	integer	聚合窗口内的成交笔数。
`results[].o`	number	该标的在给定时间段内的开盘价。
`results[].otc`	boolean	该聚合是否属于场外（OTC）标的。为 false 时该字段不返回。
`results[].t`	integer	聚合窗口起始的 Unix 毫秒时间戳。
`results[].v`	number	该标的在给定时间段内的成交量。
`results[].vw`	number	成交量加权平均价（VWAP）。
`next_url`	string	若存在，可用该值获取下一页数据。

响应示例

{
  "adjusted": true,
  "next_url": "https://api.massive.com/v2/aggs/ticker/AAPL/range/1/day/1578114000000/2020-01-10?cursor=bGltaXQ9MiZzb3J0PWFzYw",
  "queryCount": 2,
  "request_id": "6a7e466379af0a71039d60cc78e72282",
  "results": [
    {
      "c": 75.0875,
      "h": 75.15,
      "l": 73.7975,
      "n": 1,
      "o": 74.06,
      "t": 1577941200000,
      "v": 135647456,
      "vw": 74.6099
    },
    {
      "c": 74.3575,
      "h": 75.145,
      "l": 74.125,
      "n": 1,
      "o": 74.2875,
      "t": 1578027600000,
      "v": 146535512,
      "vw": 74.7026
    }
  ],
  "resultsCount": 2,
  "status": "OK",
  "ticker": "AAPL"
}

原文：Massive 文档 ↗

美股 自定义 K 线（OHLC） · REST 接口

适用场景

查询参数

响应字段

响应示例

美股自定义 K 线（OHLC） · REST 接口