# 行情_K线 调用地址：http(s)://stock.api51.cn/kline # 请求参数 |参数名|类型|必填|最大长度|默认值|中文名|描述| | --- | --- |--- | --- |--- | --- |--- | --- | |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线对象| |prod_code|String|32|产品代码| |candle_detail_data|Object|K线详细对象| |min_time|Integer|10|分时分钟时间(HHMM)| |open_px|Integer|10|开盘价| |high_px|Integer|10|最高价| |low_px|Integer|10|最低价| |close_px|Integer|10|收盘价| |business_amount|Integer|10|成交数量| |business_balance|Float|16.2|成交金额| |turnover_ratio|Integer|10|换手率|仅支持长周期K线 |preclose_px|Integer|10|前收价|