外汇自定义 K 线（OHLC） · REST 接口

外汇自定义 K 线聚合。按自定义日期范围与时间粒度（美东时区）获取指定外汇货币对的聚合开盘价、最高价、最低价、收盘价与成交量数据。与股票、期权不同，外汇聚合基于买卖报价而非成交生成；某时间窗内若无新报价，则不产生 K 线。可通过 multiplier 与 timespan 参数调整粒度，例如 5 分钟 K 线。

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

上游时效说明

盘后或实时

上游历史范围

数据可追溯至 2009 年 9 月 25 日

适用场景

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

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

查询参数

参数	类型	必填	说明
`forexTicker`	string	Yes	货币对代码。
`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[].t`	integer	聚合窗口起始的 Unix 毫秒时间戳。
`results[].v`	number	该标的在给定时间段内的成交量。
`results[].vw`	number	成交量加权平均价（VWAP）。

响应示例

{
  "adjusted": true,
  "queryCount": 1,
  "request_id": "79c061995d8b627b736170bc9653f15d",
  "results": [
    {
      "c": 1.17721,
      "h": 1.18305,
      "l": 1.1756,
      "n": 125329,
      "o": 1.17921,
      "t": 1626912000000,
      "v": 125329,
      "vw": 1.1789
    }
  ],
  "resultsCount": 1,
  "status": "OK",
  "ticker": "C:EURUSD"
}

原文：Massive 文档 ↗

外汇 自定义 K 线（OHLC） · REST 接口

适用场景

查询参数

响应字段

响应示例

外汇自定义 K 线（OHLC） · REST 接口