一、接口概述
Tushare 提供的trade_cal接口,用于获取各大交易所的交易日历数据。通过该接口,我们能够清晰地了解不同交易所的交易日期安排,这对于金融数据的分析和处理十分关键。默认情况下,提取的是上交所的交易日历数据。需要注意的是,使用该接口需消耗 2000 积分。
二、输入参数
- exchange:交易所代码,类型为字符串,非必选参数。取值包括:SSE(上交所)、SZSE(深交所)、CFFEX(中金所)、SHFE(上期所)、CZCE(郑商所)、DCE(大商所)、INE(上能源)。
- start_date:开始日期,格式为 YYYYMMDD,字符串类型,非必选参数。
- end_date:结束日期,格式为 YYYYMMDD,字符串类型,非必选参数。
- is_open:是否交易标识,'0' 表示休市,'1' 表示交易,字符串类型,非必选参数。
三、输出参数
- exchange:交易所代码,字符串类型,默认显示,如 SSE 代表上交所,SZSE 代表深交所。
- cal_date:日历日期,字符串类型,默认显示。
- is_open:是否交易,'0' 休市,'1' 交易,字符串类型,默认显示。
- pretrade_date:上一个交易日,字符串类型,默认显示。
四、接口示例
- 常规调用方式:
import tushare as ts
pro = ts.pro_api()
df = pro.trade_cal(exchange='', start_date='20180101', end_date='20181231')
- 另一种调用方式:
import tushare as ts
pro = ts.pro_api()
df = pro.query('trade_cal', start_date='20180101', end_date='20181231')
五、数据样例
exchange | cal_date | is_open |
SSE | 20180101 | 0 |
SSE | 20180102 | 1 |
SSE | 20180103 | 1 |
SSE | 20180104 | 1 |
SSE | 20180105 | 1 |
SSE | 20180106 | 0 |
SSE | 20180107 | 0 |
SSE | 20180108 | 1 |
SSE | 20180109 | 1 |
SSE | 20180110 | 1 |
六、注意事项
- 使用该接口前需确保有足够的积分,否则无法正常获取数据。
- 输入日期参数时,务必严格按照 YYYYMMDD 的格式,否则可能导致数据获取失败。
- 若不指定exchange参数,默认获取上交所数据,如需获取其他交易所数据,需明确传入对应交易所代码。