当前 K 线
GET/api/v1.0/quote/{symbol}/cur-kline获取标的当前 K 线数据，返回距今最新 num 根 K 线，支持分钟/日/周/月/年/季多种周期与复权方式。仅返回最新 N 条。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
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 枚举表。 |
pred_side | int | 查询 | 否 | 仅事件合约：0 按 symbol 原样（默认），1 YES，2 NO；其他品类忽略。 |
枚举 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 "https://webapi.moomoo.com/api/v1.0/quote/HK.00700/cur-kline?num=2&ktype=2&autype=1" | jq响应字段
返回 data.kline_list[]，每个元素一根 K 线：
| 字段 | 类型 | 说明 |
|---|---|---|
| code | string | 标的代码，例 HK.00700 |
| name | string | 英文名 |
| sc_name | string | 简体中文名 |
| tc_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 |
限制范围
- code 必须使用接口支持且已开通行情权限的市场前缀；下表列出常见市场，其他已注册前缀同样可能受支持，否则返回
invalid_symbol。 - 盘前盘后：
extended_time=1仅对美股 1 分 K（ktype=1）生效；其他 ktype 或非美股市场该开关被忽略。
常见市场前缀与品类：
| 前缀 | 市场 | 支持品类 |
|---|---|---|
| HK | 香港 | 正股 / 信托 / REIT / 窝轮 / 牛熊证 / 界内证 / 指数 / 板块 / ETF / 期权 |
| US | 美国 | 正股 / ETF / 指数 |
| SH | 上海 | 正股 / ETF / 指数 / 板块 |
| SZ | 深圳 | 正股 / ETF / 指数 / 板块 |
| BJ | 北京 | 正股 / 指数 |
| KR | 韩国 | 正股 / ETF / 指数 |
错误码
| 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": "TENCENT",
"sc_name": "腾讯控股",
"tc_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": "TENCENT",
"sc_name": "腾讯控股",
"tc_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
}
]
}
}