历史 K 线
GET/v1/quote/{symbol}/history-kline获取指定时间区间的历史 K 线数据，支持向更早翻页。返回 K 线时间、日期、时区、开/收/高/低、成交量与成交额、昨收、市盈率、换手率、相对昨收涨跌幅、股票名称；期货/期权另含持仓量、结算价、隐含波动率。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 标的代码，例：US.FUTU / HK.00700 |
start | string | 查询 | 否 | 起始日期 yyyy-MM-dd（含），不传则按 num 从 end 往前推 |
end | string | 查询 | 是 | 结束日期 yyyy-MM-dd（含） |
ktype | int | 查询 | 否 | K 线类型，默认 2。详见命名词典 > ktype |
autype | int | 查询 | 否 | 复权类型，默认 1。详见命名词典 > autype |
num | int | 查询 | 否 | 数量，默认 370，最大 370 |
extended_time | int | 查询 | 否 | 盘前盘后开关，默认 0。详见命名词典 > extended_time |
请求示例
bash
curl -s "$ip/v1/quote/US.FUTU/history-kline?start=2026-05-20&end=2026-05-23" | jq响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
kline_list[].time_key | int | K 线时间，毫秒时间戳 |
kline_list[].date | int | K 线日期 YYYYMMDD（分 K 为所属交易日，日 K 及以上为时间戳对应的当地日期） |
kline_list[].time_zone | int | 时区偏移（分钟，相对 UTC），例：480(HK) / -300(US 夏令) |
kline_list[].open | float | 开盘价 |
kline_list[].close | float | 收盘价 |
kline_list[].high | float | 最高价 |
kline_list[].low | float | 最低价 |
kline_list[].volume | int | 成交量（股） |
kline_list[].turnover | float | 成交额 |
kline_list[].last_close | float | 昨收价 |
kline_list[].pe_ratio | float | 市盈率 |
kline_list[].turnover_rate | float | 换手率（百分数） |
kline_list[].change_rate | float | 涨跌幅（百分数，相对昨收） |
kline_list[].name | string | 股票名称 |
kline_list[].open_interest | int | 持仓量。仅期货/期权返回，其他品类为 0 或不返回 |
kline_list[].settle_price | float | 结算价。仅对期货/期权（日 K 及以上）有结算意义；股票/ETF/指数等品类后端会回填为收盘价 close，调用方应忽略 |
kline_list[].implied_volatility | float | 隐含波动率（百分数）。仅期权返回，其他品类为 0 或不返回 |
next_time | int | 下一页起始时间（毫秒时间戳，作为下一页 end 回传） |
volume_precision | int | 成交量精度 n。kline_list[].volume 已被放大 10^n 倍，调用方需自行除以 10^n 还原。仅事件合约/数字货币等特殊品类可能 >0；股票/ETF/期货/期权一般为 0 |
限制范围
- 支持市场：HK / US / SH / SZ / BJ / SG / CA / AU / FX / JP / CC / FT 等已注册市场前缀。
- 支持品类：股票 / ETF / 指数 / 期货 / 期权 / 数字货币等；优先股 / SPAC / 可转债 / 牛熊证（CBBC）等不支持品类后端返回空 kline_list。
- 市场前缀未在网关枚举内（如 UK / IT 等）：返回 ret_code=-8 unsupported。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| 0 | — | 成功；合法但无数据时 kline_list 为空数组 | — |
| -3 | invalid_parameter | 缺必填（end）/ 类型错 / 枚举非法（ktype 越界）/ 日期格式不符 | 校正参数后重试 |
| -7 | invalid_symbol | symbol 格式合法但证券缓存查无（如 HK.99999999） | 通过 search 接口确认代码合法性 |
| -8 | unsupported | 市场前缀不在网关支持范围（如 UK.HSBA / IT.STM） | 确认市场前缀是否受支持 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"kline_list": [
{
"change_rate": 0.17670682730923695,
"close": 124.72,
"high": 127.45,
"last_close": 124.5,
"low": 122.7,
"name": "富途控股",
"open": 124.12,
"pe_ratio": 17.728,
"time_key": 1779249600000,
"turnover": 370529897,
"turnover_rate": 0.49348,
"volume": 2960896
},
{
"change_rate": -0.689544579858884,
"close": 123.86,
"high": 125.45,
"last_close": 124.72,
"low": 122.1,
"name": "富途控股",
"open": 122.7,
"pe_ratio": 17.606,
"time_key": 1779336000000,
"turnover": 271859605,
"turnover_rate": 0.36631,
"volume": 2197832
}
]
}
}