- 功能描述:获取指数的基础信息,例如指数代码、全称简称、发布方、基期、加权方式等
- 返回限量:单次请求最大返回8000行
- 接口权限:2000积分200次/分钟;5000积分500次/分钟
- 说明:
1. 每日18:00更新;
2. 同一个指数可能由于披露方不同,导致产生了多个指数代码,示例4有详细讲解;
输入参数:
名称 |
类型 |
必选 |
描述 |
ts_code |
str |
N |
TS指数代码 |
symbol |
str |
N |
指数代码,支持多值输入,如000300,000001 |
name |
str |
N |
指数简称 |
market |
str |
N |
交易所或服务商(详见下方说明) |
publisher |
str |
N |
发布商 |
category |
str |
N |
指数类别 |
输出参数:
名称 |
类型 |
默认显示 |
描述 |
ts_code |
str |
Y |
TS代码 |
name |
str |
Y |
简称 |
fullname |
str |
N |
指数全称 |
market |
str |
Y |
市场 |
publisher |
str |
Y |
发布方 |
index_type |
str |
N |
指数风格 |
category |
str |
Y |
指数类别 |
base_date |
str |
Y |
基期 |
base_point |
float |
Y |
基点 |
list_date |
str |
Y |
发布日期 |
weight_rule |
str |
N |
加权方式 |
desc |
str |
N |
描述 |
exp_date |
str |
N |
终止日期 |
- 市场代码对应的市场名称为:MSCI-MSCI指数; CSI-中证指数; SSE-上交所指数; SZSE-深交所指数; CICC-中金指数; SW-申万指数; OTH-其他指数;
- 目前所包含的指数类别有:主题指数、规模指数、策略指数、风格指数、综合指数、成长指数、价值指数、有色指数、化工指数、能源指数、其他指数、外汇指数、基金指数、商品指数、债券指数、行业指数、贵金属指数、农副产品指数、软商品指数、油脂油料指数、非金属建材指数、煤焦钢矿指数、谷物指数;
示例:
示例1:查询所有上交所指数
通过仅传递交易所或服务商代码market即可获得所有该交易所或服务商发布的所有指数基础信息。
其中中证指数总数超过了8000行记录;
import tushare as ts pro = ts.pro_api() df = pro.index_basic(market='SSE') df
输出结果:
ts_code name market publisher category base_date base_point list_date 0 000001.SH 上证指数 SSE 中证指数有限公司、上海证券交易所 综合指数 19901219 100.00 19910715 1 000002.SH A股指数 SSE 中证指数有限公司、上海证券交易所 规模指数 19901219 100.00 19920221 2 000003.SH B股指数 SSE 中证指数有限公司、上海证券交易所 规模指数 19920221 100.00 19920817 3 000004.SH 工业指数 SSE 中证指数有限公司、上海证券交易所 行业指数 19930430 1358.78 19930503 4 000005.SH 商业指数 SSE 中证指数有限公司、上海证券交易所 行业指数 19930430 1358.78 19930503 ... ... ... ... ... ... ... ... ... 203 000992.SH 金融地产 SSE 中证指数有限公司 主题指数 20041231 1000.00 20110802 204 000993.SH 全指信息 SSE 中证指数有限公司 行业指数 20041231 1000.00 20110802 205 000996.SH 领先行业 SSE 中证指数有限公司 主题指数 20041231 1000.00 20110802 206 000997.SH 大消费 SSE 中证指数有限公司 主题指数 20041231 1000.00 20111111 207 000999.SH 两岸三地 SSE 中证指数有限公司 规模指数 20041231 1000.00 20100118 208 rows × 8 columns
示例2:获取全部字段
通过显式传递fields参数来获取包含未默认显示的字段。
fields = 'ts_code,name,fullname,market,publisher,index_type,category,base_date,base_point,list_date,weight_rule,desc,exp_date' df = pro.index_basic(market='SSE', fields=fields) df.head(1).T
输出结果:
0 ts_code 000001.SH name 上证指数 fullname 上证综合指数 market SSE publisher 中证指数有限公司、上海证券交易所 index_type None category 综合指数 base_date 19901219 base_point 100.0 list_date 19910715 weight_rule 总市值加权 desc 上证综合指数由在上海证券交易所上市的符合条件的股票与存托凭证组成样本,反映上海证券交易所上市... exp_date None
示例3:获取所有申万(SW)行业指数
通过传递category可指定指数类别。如本示例指定了market为“SW”、category为“行业指数”即可获取申万行业指数。
df = pro.index_basic(market='SW', category='行业指数') df
输出结果:
ts_code name market publisher category base_date base_point list_date 0 801010.SI 申万农林牧渔 SW 上海申银万国证券研究所有限公司 行业指数 19991230 1000.0 20031015 1 801011.SI 申万林业Ⅱ SW 上海申银万国证券研究所有限公司 行业指数 19991230 1000.0 20031015 2 801012.SI 申万农产品加工 SW 上海申银万国证券研究所有限公司 行业指数 19991230 1000.0 20031015 3 801013.SI 申万农业综合Ⅱ SW 上海申银万国证券研究所有限公司 行业指数 19991230 1000.0 20031015 4 801014.SI 申万饲料Ⅱ SW 上海申银万国证券研究所有限公司 行业指数 19991230 1000.0 20031015 ... ... ... ... ... ... ... ... ... 764 859851.SI 申万学历教育 SW 上海申银万国证券研究所有限公司 行业指数 19991230 1000.0 20211213 765 859852.SI 申万培训教育 SW 上海申银万国证券研究所有限公司 行业指数 19991230 1000.0 20211213 766 859853.SI 申万教育运营及其他 SW 上海申银万国证券研究所有限公司 行业指数 19991230 1000.0 20211213 767 859931.SI 申万博彩 SW 上海申银万国证券研究所有限公司 行业指数 19991230 1000.0 20211213 768 859951.SI 申万电视广播Ⅲ SW 上海申银万国证券研究所有限公司 行业指数 19991230 1000.0 20211213 769 rows × 8 columns
示例4:通过指数简称查找指数信息
通过传递name字段,可获取指定指数简称的指数基础信息。有一些指数有两个指数代码,3和0开头,3是有国证指数(SZ)披露,0是中证指数(CSI)披露。如果查询不到指数行情,不妨使用指数名称查询一下指数信息,看看是不是由于披露方不同代码不同导致数据有异常。
df = pro.index_basic(name='沪深300') df
输出结果:
ts_code name market publisher category base_date base_point list_date 0 000300.SH 沪深300 SSE 中证指数有限公司、上海证券交易所 规模指数 20041231 1000.0 20050408 1 399300.SZ 沪深300 SZSE 深圳证券交易所 规模指数 20041231 1000.0 20050408
示例5:通过指数代码查找指数信息
通过传递symbol字段,可获取指定指数代码的指数基础信息。如要获取多个指数的基础信息,则可以在symbol字段传入以英文逗号分割的指数代码列表字符串。
这样在指数行情(如
index_daily)等其他接口需要传入ts_code字段而不确定后缀的时候,可使用该方法将指数代码symbol转换为ts_code。
df = pro.index_basic(symbol='000300,000001') df
输出结果:
ts_code name market publisher category base_date base_point list_date 0 000001.SH 上证指数 SSE 中证指数有限公司、上海证券交易所 综合指数 19901219 100.0 19910715 1 000300.SH 沪深300 SSE 中证指数有限公司、上海证券交易所 规模指数 20041231 1000.0 20050408
说明:
本文说明
本文旨在对Tushare的指数基本信息index_basic数据接口进行介绍,提供更多参考示例和使用说明。
通过本接口可获取指数的基础信息,例如指数代码、全称简称、发布方、基期、加权方式等。在指数行情等多个需要依赖ts_code而不清楚后缀的情况下,可以使用该接口获取指数代码symbol与ts_code的对应关系。本文还介绍了如何通过传递market和category字段分别指定发布指数的交易所或服务商以及指数分类。
本文目的是为了让用户和AIGC工具能够更便捷、准确地使用该接口。大家在使用过程中遇到什么问题和建议可在线留言,作者会进行数据探索将结果更新到文章中,并将建议反馈给Tushare团队。本文另一个目的也是为了聚集大家的智慧以创建“我为人人,人人为我”的共创氛围。