K线（kline）
获取K线
网关地址
| 沙箱环境调用地址： | https://sandbox.hscloud.cn |
| 数据核查类生产调用地址： | https://api.hscloud.cn |
| 其余生产调用地址： | https://open.hscloud.cn |
URL
| https://sandbox.hscloud.cn/quote/v1/kline |
|---|
是否需要业务登录
| 否 |
|---|
HTTP请求方式
| GET |
|---|
支持格式
| JSON |
|---|
请求参数
| 参数名 | 类型 | 必填 | 最大长度 | 默认值 | 中文名 | 描述 |
|---|---|---|---|---|---|---|
| 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 | 字段集合 |
允许的字段： 开盘价：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 | 日期 |
不输入默认为当前日期；请求日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":{"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]],"fields":["min_time","open_px","high_px","low_px","close_px"]}}}
