Skip to content

当前 K 线 ​

GET /api/v1.0/quote/{symbol}/cur-kline

获取标的当前 K 线数据,返回距今最新 num 根 K 线,支持分钟/日/周/月/年/季多种周期与复权方式。仅返回最新 N 条。

请求参数 ​

参数类型位置必填说明
symbolstring路径是标的代码,如 HK.00700。
numint查询是K 线数量,1~370。
ktypeint查询否K 线类型,默认 2。详见下方 ktype 枚举表。
autypeint查询否复权类型,默认 1。详见下方 autype 枚举表。
extended_timeint查询否盘前盘后/夜盘开关,默认 0(仅美股 1 分 K 生效)。详见下方 extended_time 枚举表。
pred_sideint查询否仅事件合约:0 按 symbol 原样(默认),1 YES,2 NO;其他品类忽略。

枚举 ktype(K 线类型)

取值含义
11 分钟
2日
3周
4月
5年
65 分钟
715 分钟
830 分钟
960 分钟
103 分钟
11季
14120 分钟
15240 分钟
2610 分钟
29180 分钟

枚举 autype(复权类型)

取值含义
0不复权
1前复权(不含股息)
2后复权(不含股息)
3前复权(含股息)
4后复权(含股息)

枚举 extended_time(盘前盘后 / 夜盘开关)

取值含义
0默认(不含盘前盘后)
1含盘前盘后
2含夜盘

请求示例 ​

bash
curl -s "https://webapi.futunn.com/api/v1.0/quote/HK.00700/cur-kline?num=2&ktype=2&autype=1" | jq

响应字段 ​

返回 data.kline_list[],每个元素一根 K 线:

参数类型说明
dataobject
data.kline_listobject[]
data.kline_list[].codestring标的代码,例: HK.00700
data.kline_list[].namestring股票英文名
data.kline_list[].sc_namestring股票简体中文名
data.kline_list[].tc_namestring股票繁体中文名
data.kline_list[].time_keyintK 线时间,毫秒时间戳,例: 1779897600000
data.kline_list[].dateintK 线日期,YYYYMMDD 整数(分 K 为所属交易日,日 K 及以上为本地日期),例: 20260520
data.kline_list[].open_pricenumber开盘价,例: 425.4
data.kline_list[].close_pricenumber收盘价,例: 425
data.kline_list[].high_pricenumber最高价,例: 432.8
data.kline_list[].low_pricenumber最低价,例: 420.4
data.kline_list[].volumeint成交量(股),例: 42196103
data.kline_list[].turnovernumber成交额,例: 17926587091
data.kline_list[].last_close_pricenumber昨收价,例: 434.4
data.kline_list[].penumber市盈率(PE),例: 15.567
data.kline_list[].change_ratenumber涨跌幅(百分数,20 表示 20%)= (close_price - last_close_price) / last_close_price × 100,例: -1.243
data.kline_list[].turnover_ratenumber换手率(百分数),例: 0.00463
paginationobject部分接口返回分页信息

限制范围 ​

  • code 必须使用接口支持且已开通行情权限的市场前缀;下表列出常见市场,其他已注册前缀同样可能受支持,否则返回 invalid_symbol。
  • 盘前盘后:extended_time=1 仅对美股 1 分 K(ktype=1)生效;其他 ktype 或非美股市场该开关被忽略。

常见市场前缀与品类:

前缀市场支持品类
HK香港正股 / 信托 / REIT / 窝轮 / 牛熊证 / 界内证 / 指数 / 板块 / ETF / 期权
US美国正股 / ETF / 指数
SH上海正股 / ETF / 指数 / 板块
SZ深圳正股 / ETF / 指数 / 板块
BJ北京正股 / 指数
KR韩国正股 / ETF / 指数

错误码 ​

ret_codeerror.code触发场景处理建议
0—成功—
-3invalid_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
      }
    ]
  }
}