# 行情_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|前收價|