当前 K 线
GET/v1/quote/{symbol}/cur-kline获取标的当前 K 线数据，返回距今最新 num 根 K 线，支持分钟/日/周/月/年/季多种周期与复权方式。仅返回最新 N 条，不能指定历史区间——指定时间区间请用 get_history_kline。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 标的代码，如 HK.00700。 |
num | int | 查询 | 是 | K 线数量，1~370。 |
ktype | int | 查询 | 否 | K 线类型，默认 2。详见下方 ktype 枚举表。 |
autype | int | 查询 | 否 | 复权类型，默认 1。详见下方 autype 枚举表。 |
extended_time | int | 查询 | 否 | 盘前盘后/夜盘开关，默认 0（仅美股 1 分 K 生效）。详见下方 extended_time 枚举表。 |
枚举 ktype（K 线类型）
| 取值 | 含义 |
|---|---|
| 1 | 1 分钟 |
| 2 | 日 |
| 3 | 周 |
| 4 | 月 |
| 5 | 年 |
| 6 | 5 分钟 |
| 7 | 15 分钟 |
| 8 | 30 分钟 |
| 9 | 60 分钟 |
| 10 | 3 分钟 |
| 11 | 季 |
| 14 | 120 分钟 |
| 15 | 240 分钟 |
| 26 | 10 分钟 |
| 29 | 180 分钟 |
枚举 autype（复权类型）
| 取值 | 含义 |
|---|---|
| 0 | 不复权 |
| 1 | 前复权（不含股息） |
| 2 | 后复权（不含股息） |
| 3 | 前复权（含股息） |
| 4 | 后复权（含股息） |
枚举 extended_time（盘前盘后 / 夜盘开关）
| 取值 | 含义 |
|---|---|
| 0 | 默认（不含盘前盘后） |
| 1 | 含盘前盘后 |
| 2 | 含夜盘 |
请求示例
bash
curl -s "$ip/v1/quote/HK.00700/cur-kline?num=2&ktype=2&autype=1" | jq响应字段
返回 data.kline_list[]，每个元素一根 K 线：
| 字段 | 类型 | 说明 |
|---|---|---|
| code | string | 标的代码，例 HK.00700 |
| name | string | 标的名称 |
| time_key | int | K 线时间，毫秒时间戳 |
| date | int | K 线日期，YYYYMMDD 整数（分 K 为所属交易日，日 K 及以上为本地日期），例 20260601 |
| open_price | float | 开盘价 |
| close_price | float | 收盘价（最新一根为最新价） |
| high_price | float | 最高价 |
| low_price | float | 最低价 |
| last_close_price | float | 昨收价 |
| volume | int | 成交量（股） |
| turnover | float | 成交额 |
| turnover_rate | float | 换手率（百分数，20 表示 20%）；值为 0 时字段可能省略 |
| pe | float | 市盈率 |
| change_rate | float | 涨跌幅（百分数）= (close_price - last_close_price) / last_close_price x 100 |
限制范围
- 盘前盘后：
extended_time=1仅对美股 1 分 K（ktype=1）生效；其他 ktype 或非美股市场该开关被忽略。
错误码
| ret_code | error.code | 触发场景 | 处理建议 |
|---|---|---|---|
| 0 | — | 成功 | — |
| -3 | invalid_parameter | 必填缺失（如 num）/ 类型错 / 越界（num>370）/ 枚举非法（ktype/autype 不在合法值集） | 检查请求参数是否符合入参约束 |
| -4 | — | 标的代码非法或参数装配失败（如 HK.99999999 查不到证券） | 校验标的代码是否真实存在 |
| -5 | — | 后端调用失败（网络/超时） | 重试；持续失败请联系后端排查 |
| >0 | — | 后端业务错误透传（无权限、风控、限频等） | 按 ret_msg 文案判断；权限类错误请确认账号已开通对应市场实时行情 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"kline_list": [
{
"code": "HK.00700",
"name": "腾讯控股",
"time_key": 1780243200000,
"date": 20260601,
"open_price": 432.4,
"close_price": 436,
"high_price": 442,
"low_price": 430,
"last_close_price": 505,
"volume": 35164391,
"turnover": 15331009622,
"turnover_rate": 0.00386,
"pe": 15.97,
"change_rate": -13.663366336633665
},
{
"code": "HK.00700",
"name": "腾讯控股",
"time_key": 1780329600000,
"date": 20260602,
"open_price": 438,
"close_price": 481.6,
"high_price": 484.8,
"low_price": 437.4,
"last_close_price": 436,
"volume": 101874275,
"turnover": 47789124229,
"turnover_rate": 0.01117,
"pe": 17.64,
"change_rate": 10.458715596330276
}
]
}
}