K线(kline) 在线调试
获取K线
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 | Integer | 否 | 8 | 开始日期 |
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 | Integer | 否 | 8 | 截止日期 |
默认为当前日期;
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=600570.SS&candle_period=1&fields=open_px,high_px,low_px,close_px&search_direction=2&date=20150106&min_time=1400&data_count=20
