K线(kline) 在线调试

获取K线

网关地址

沙箱环境调用地址: https://sandbox.hscloud.cn
数据核查类生产调用地址: https://api.hscloud.cn
仿真业务接口生产调用地址: https://vopen.hscloud.cn
其余生产调用地址: https://open.hscloud.cn

URL

https://sandbox.hscloud.cn/quote/v1/kline

是否需要业务登录

HTTP请求方式

GET

请求参数

参数名 类型 必填 最大长度 默认值 中文名 描述
get_type String 1 查找类别
offset 按偏移查找;range 按日期区间查找;必须输入其中一个值
prod_code String 32 产品代码
有且仅能有 1 个代码;证券代码包含交易所代码做后缀,作为该代码的唯一标识。如:600570.SS
candle_period Integer 10 K线周期
取值可以是数字1-9,表示含义如下: 1:1分钟K线 2:5分钟K线 3:15分钟K线 4:30分钟K线 5:60分钟K线 6:日K线 7:周K线 8:月K线 9:年K线
candle_mode Integer 10 0 K线模式
0:原始K线 1:前复权K线 2:后复权K线
fields String 255 字段集合
若不指定,默认返回min_time,open_px,high_px,low_px ,close_px,business_amount,business_balance;如需返回更多,请传字段参数名,多个参数用英文逗号隔开
search_direction Integer 10 1 搜索方向
1 表示向前查找(默认值) ,2 表示向后查找。 仅在 get_type=offset 时有效。
date Integer 8 日期
不输入默认为0,0的业务含义为大于最后交易日的日期;请求日K线时,如果输入日期,不返回该日期的K线 get_type=offset时有效
min_time Integer 10 分时分钟时间(HHMM)
分钟 K 线的时间 HHMM,对于 短 周期 K 线 类型 使用(1min,5min 等),不填写表示最新的市场时间,若填写必须同时填写 date 字段。请求分钟K线时,如果输入该字段,不返回输入分钟的K线 仅在 get_type=offset 且candle_period=1~5(分钟 K线)时有效。
data_count Integer 10 10 数据个数
需要取得的 K 线的根数,如果该字段不存在,取值范围[1, 1000],默认为 10 个。 仅在 get_type=offset 时有效。
start_date String 开始日期
1、 start_date 和 end_date 均不填, 返回距离当前日期的1000 根 K 线; 2、 仅填 start_date, 当 start_date和最新日期之间的数据不足1000 根,返回 start_date 和最新日期之间的数据;如果数据超过 1000 根 K 线, 则返回距离当前日期的 1000 根 K线; 3、 仅填 end_date , 返 回end_date 之前存在的的最多1000 根 K 线; 4、 start_date 和 end_date 均填充,返回该日期区间(闭区间)的数据,最多 1000 根。 仅在 get_type=range 时有效。
end_date String 截止日期
默认为当前日期; 1、 start_date 和 end_date 均不填, 返回距离当前日期的1000 根 K 线; 2、 仅填 start_date, 当 start_date和最新日期之间的数据不足1000 根,返回 start_date 和最新日期之间的数据;如果数据超过 1000 根 K 线, 则返回距离当前日期的 1000 根 K线; 3、 仅填 end_date , 返 回end_date 之前存在的的最多1000 根 K 线; 4、 start_date 和 end_date 均填充,返回该日期区间(闭区间)的数据,最多 1000 根。 仅在 get_type=range 时有效。

返回参数

参数名 类型 最大长度 默认值 中文名 描述
candle Object K线对象

请求示例

/quote/v1/kline?get_type=offset&prod_code=00001.HKM&candle_period=6&fields=open_px,high_px,low_px,close_px&search_direction=2&date=20180106&data_count=20

正确返回示例

{"data":{"candle":{"fields":["min_time","open_px","high_px","low_px","close_px"],"00001.HKM":[[20180108,99.95,99.95,99.1,99.35],[20180109,100,100,98.9,99.25],[20180110,98.8,99,98.2,98.95],[20180111,99.65,99.65,99,99.15],[20180112,100,101.8,99.45,101.2],[20180115,102.4,102.8,100.1,100.5],[20180116,101,101.1,100.1,100.5],[20180117,100.4,101.8,100.2,100.5],[20180118,100.5,101.9,100.5,100.9],[20180119,100.9,101.2,100.3,100.7],[20180122,101.6,102.6,101.3,102.6],[20180123,103,103.4,102.2,102.6],[20180124,102.7,105.3,102.7,104.6],[20180125,106.6,107,105.5,106.4],[20180126,107,107,106.4,106.7],[20180129,106.5,106.9,104.7,104.8],[20180130,105,107,104.8,105.1],[20180131,104.9,106,104.7,105.6],[20180201,105.6,105.9,105.2,105.5],[20180202,105.7,105.7,104.8,105.2]]}}}