tushare

# Tushare ## 概述 tushare是一个财经数据接口包，拥有丰富的数据内容，如股票、基金、期货、数字货币等行情数据，公司财务、基金经理等基本面数据。该模块通过标准化API方式统一了数据资产的对外服务方式，以帮助有需要的技术用户更实时、简洁、轻量的使用相关数据。 ## 快速上手 - 安装python运行环境(推荐python3.7+)，并安装tushare依赖包(推荐从清华pypi镜像安装)。 ```bash pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple ``` - Tushare官网注册，获取token，并配置环境变量。 [注册地址](https://tushare.pro/register) ```bash export TUSHARE_TOKEN=your_token ``` - 查询Tushare接口文档，找到对应的接口。 [在线数据接口文档](https://tushare.pro/document/2) - 根据接口文档，使用python代码获取数据。（如**股票列表**接口） ```python import os import tushare as ts # 读取环境变量中的token, 或者读取本地记录的token token = os.getenv('TUSHARE_TOKEN') or ts.get_token() # 初始化pro接口实例 pro = ts.pro_api(token) # 查询数据接口（*股票列表*），获取上市交易的股票列表 df = pro.stock_basic(list_status='L', fields='ts_code,symbol,name,area,industry,list_date') print(df) ``` ## 参数格式说明 - 日期：YYYYMMDD（如 20241231） - 股票代码：ts_code 格式（如 000001.SZ, 600000.SH） - 返回格式：pandas DataFrame > 链接约定：本文档内所有指向 `references/` 的链接均以 **相对本文档** 的形式书写（如 `references/...`），这是 GitHub 在浏览器中打开该文件时解析的形式。`read_file` 工具会把同一字符串解析到拥有它的技能目录下，因此人和 agent 读到的是同一份文件。新增技能文档时务必沿用相对形式，并保证 references 路径在各技能之间不重名：两个技能同时拥有的路径会被报为歧义，而不会被猜测。 ## python脚本示例 - [股票数据获取示例](scripts/stock_data_example.py) - [基金数据获取示例](scripts/fund_data_example.py) ## 数据接口列表 | ID | 接口名 | 标题(详细文档) | 分类 | 描述 | | ----: | :------------------- | :--------------------------------------------------------------------------------------------------------- | :---------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 416 | rt_min | [ETF实时分钟](references/ETF专题/ETF实时分钟.md) | ETF专题 | 获取ETF实时分钟数据，包括1~60min | | 400 | rt_etf_k | [ETF实时日线](references/ETF专题/ETF实时日线.md) | ETF专题 | 获取ETF实时日k线行情，支持按ETF代码或代码通配符一次性提取全部ETF实时日k线行情 | | 387 | stk_mins | [ETF历史分钟](references/ETF专题/ETF历史分钟.md) | ETF专题 | 获取ETF分钟数据，支持1min/5min/15min/30min/60min行情，提供Python SDK和 http Restful API两种方式 | | 386 | etf_index | [ETF基准指数](references/ETF专题/ETF基准指数.md) | ETF专题 | 获取ETF基准指数列表信息 | | 385 | etf_basic | [ETF基本信息](references/ETF专题/ETF基本信息.md) | ETF专题 | 获取国内ETF基础信息，包括了QDII。数据来源与沪深交易所公开披露信息。 | | 199 | fund_adj | [ETF复权因子](references/ETF专题/ETF复权因子.md) | ETF专题 | 获取基金复权因子，用于计算基金复权行情 | | 127 | fund_daily | [ETF日线行情](references/ETF专题/ETF日线行情.md) | ETF专题 | 获取ETF行情每日收盘后成交数据，历史超过10年 | | 408 | etf_share_size | [ETF份额规模](references/ETF专题/ETF份额规模.md) | ETF专题 | 获取沪深ETF每日份额和规模数据，能体现规模份额的变化，掌握ETF资金动向，同时提供每日净值和收盘价；数据指标是分批入库，建议在每日19点后提取；另外，涉及海外的ETF数据更新会晚一些属于正常情况。 | | 322 | bc_otcqt | [柜台流通式债券报价](references/债券专题/柜台流通式债券报价.md) | 债券专题 | 柜台流通式债券报价 | | 305 | cb_rate | [可转债票面利率](references/债券专题/可转债票面利率.md) | 债券专题 | 获取可转债票面利率 | | 272 | bond_blk_detail | [大宗交易明细](references/债券专题/大宗交易明细.md) | 债券专题 | 获取沪深交易所债券大宗交易数据，可以通过[**数据工具**](https://tushare.pro/webclient/)调试和查看数据。 | | 271 | bond_blk | [大宗交易](references/债券专题/大宗交易.md) | 债券专题 | 获取沪深交易所债券大宗交易数据，可以通过[**数据工具**](https://tushare.pro/webclient/)调试和查看数据。 | | 269 | cb_call | [可转债赎回信息](references/债券专题/可转债赎回信息.md) | 债券专题 | 获取可转债到期赎回、强制赎回等信息。数据来源于公开披露渠道，供个人和机构研究使用，请不要用于数据商业目的。 | | 256 | repo_daily | [债券回购日行情](references/债券专题/债券回购日行情.md) | 债券专题 | 债券回购日行情 | | 323 | bc_bestotcqt | [柜台流通式债券最优报价](references/债券专题/柜台流通式债券最优报价.md) | 债券专题 | 柜台流通式债券最优报价 | | 392 | cb_factor_pro | [可转债技术面因子(专业版)](references/债券专题/可转债技术面因子(专业版).md) | 债券专题 | 获取可转债每日技术面因子数据，用于跟踪可转债当前走势情况，数据由Tushare社区自产，覆盖全历史；输出参数_bfq表示不复权，_qfq表示前复权 _hfq表示后复权，描述中说明了因子的默认传参，如需要特殊参数或者更多因子可以联系管理员评估 | | 246 | cb_price_chg | [可转债转股价变动](references/债券专题/可转债转股价变动.md) | 债券专题 | 获取可转债转股价变动 | | 233 | eco_cal | [全球财经事件](references/债券专题/全球财经事件.md) | 债券专题 | 获取全球财经日历、包括经济事件数据更新 | | 201 | yc_cb | [国债收益率曲线](references/债券专题/国债收益率曲线.md) | 债券专题 | 获取中债收益率曲线，目前可获取中债国债收益率曲线即期和到期收益率曲线数据 | | 187 | cb_daily | [可转债行情](references/债券专题/可转债行情.md) | 债券专题 | 获取可转债行情 | | 186 | cb_issue | [可转债发行](references/债券专题/可转债发行.md) | 债券专题 | 获取可转债发行数据 | | 185 | cb_basic | [可转债基础信息](references/债券专题/可转债基础信息.md) | 债券专题 | 获取可转债基本信息 | | 247 | cb_share | [可转债转股结果](references/债券专题/可转债转股结果.md) | 债券专题 | 获取可转债转股结果 | | 208 | fund_manager | [基金经理](references/公募基金/基金经理.md) | 公募基金 | 获取公募基金经理数据，包括基金经理简历等数据 | | 207 | fund_share | [基金规模](references/公募基金/基金规模.md) | 公募基金 | 获取基金规模数据，包含上海和深圳ETF基金 | | 121 | fund_portfolio | [基金持仓](references/公募基金/基金持仓.md) | 公募基金 | 获取公募基金持仓数据，季度更新 | | 120 | fund_div | [基金分红](references/公募基金/基金分红.md) | 公募基金 | 获取公募基金分红数据 | | 119 | fund_nav | [基金净值](references/公募基金/基金净值.md) | 公募基金 | 获取公募基金净值数据 | | 118 | fund_company | [基金管理人](references/公募基金/基金管理人.md) | 公募基金 | 获取公募基金管理人列表 | | 19 | fund_basic | [基金列表](references/公募基金/基金列表.md) | 公募基金 | 获取公募基金数据列表，包括场内和场外基金 | | 359 | fund_factor_pro | [基金技术面因子(专业版)](references/公募基金/基金技术面因子(专业版).md) | 公募基金 | 获取场内基金每日技术面因子数据，用于跟踪场内基金当前走势情况，数据由Tushare社区自产，覆盖全历史；输出参数_bfq表示不复权，描述中说明了因子的默认传参，如需要特殊参数或者更多因子可以联系管理员评估 | | 178 | fx_obasic | [外汇基础信息(海外)](references/外汇数据/外汇基础信息(海外).md) | 外汇数据 | 获取海外外汇基础信息，目前只有FXCM交易商的数据 | | 179 | fx_daily | [外汇日线行情](references/外汇数据/外汇日线行情.md) | 外汇数据 | 获取外汇日线行情 | | 415 | research_report | [券商研究报告](references/大模型语料专题数据/券商研究报告.md) | 大模型语料专题数据 | 获取券商研究报告-个股、行业等，历史数据从20170101开始提供，增量每天两次更新 | | 143 | news | [新闻快讯(短讯)](references/大模型语料专题数据/新闻快讯(短讯).md) | 大模型语料专题数据 | 获取主流新闻网站的快讯新闻数据,提供超过6年以上历史新闻。 | | 154 | cctv_news | [新闻联播文字稿](references/大模型语料专题数据/新闻联播文字稿.md) | 大模型语料专题数据 | 获取新闻联播文字稿数据，数据开始于2017年。 | | 176 | anns_d | [上市公司公告](references/大模型语料专题数据/上市公司公告.md) | 大模型语料专题数据 | 获取全量公告数据，提供pdf下载URL | | 367 | irm_qa_sz | [深证易互动问答](references/大模型语料专题数据/深证易互动问答.md) | 大模型语料专题数据 | | | 366 | irm_qa_sh | [上证e互动问答](references/大模型语料专题数据/上证e互动问答.md) | 大模型语料专题数据 | | | 195 | major_news | [新闻通讯(长篇)](references/大模型语料专题数据/新闻通讯(长篇).md) | 大模型语料专题数据 | 获取长篇通讯信息，覆盖主要新闻资讯网站，提供超过8年历史新闻。 | | 406 | npr | [国家政策库](references/大模型语料专题数据/国家政策库.md) | 大模型语料专题数据 | 获取国家行政机关公开披露的各类法规、条例政策、批复、通知等文本数据。 | | 245 | cn_ppi | [工业生产者出厂价格指数(PPI)](references/宏观经济/国内宏观/价格指数/工业生产者出厂价格指数(PPI).md) | 宏观经济,国内宏观,价格指数 | 获取PPI工业生产者出厂价格指数数据 | | 228 | cn_cpi | [居民消费价格指数(CPI)](references/宏观经济/国内宏观/价格指数/居民消费价格指数(CPI).md) | 宏观经济,国内宏观,价格指数 | 获取CPI居民消费价格数据，包括全国、城市和农村的数据 | | 149 | shibor | [Shibor利率](references/宏观经济/国内宏观/利率数据/Shibor利率.md) | 宏观经济,国内宏观,利率数据 | shibor利率 | | 151 | shibor_lpr | [LPR贷款基础利率](references/宏观经济/国内宏观/利率数据/LPR贷款基础利率.md) | 宏观经济,国内宏观,利率数据 | LPR贷款基础利率 | | 152 | libor | [Libor利率](references/宏观经济/国内宏观/利率数据/Libor利率.md) | 宏观经济,国内宏观,利率数据 | Libor拆借利率 | | 150 | shibor_quote | [Shibor报价数据](references/宏观经济/国内宏观/利率数据/Shibor报价数据.md) | 宏观经济,国内宏观,利率数据 | Shibor报价数据 | | 173 | wz_index | [温州民间借贷利率](references/宏观经济/国内宏观/利率数据/温州民间借贷利率.md) | 宏观经济,国内宏观,利率数据 | 温州民间借贷利率，即温州指数 | | 153 | hibor | [Hibor利率](references/宏观经济/国内宏观/利率数据/Hibor利率.md) | 宏观经济,国内宏观,利率数据 | Hibor利率 | | 174 | gz_index | [广州民间借贷利率](references/宏观经济/国内宏观/利率数据/广州民间借贷利率.md) | 宏观经济,国内宏观,利率数据 | 广州民间借贷利率 | | 227 | cn_gdp | [国内生产总值(GDP)](references/宏观经济/国内宏观/国民经济/国内生产总值(GDP).md) | 宏观经济,国内宏观,国民经济 | 获取国民经济之GDP数据 | | 325 | cn_pmi | [采购经理指数(PMI)](references/宏观经济/国内宏观/景气度/采购经理指数(PMI).md) | 宏观经济,国内宏观,景气度 | 采购经理人指数 | | 310 | sf_month | [社融增量(月度)](references/宏观经济/国内宏观/金融/社会融资/社融增量(月度).md) | 宏观经济,国内宏观,金融,社会融资 | 获取月度社会融资数据 | | 242 | cn_m | [货币供应量(月)](references/宏观经济/国内宏观/金融/货币供应量/货币供应量(月).md) | 宏观经济,国内宏观,金融,货币供应量 | 获取货币供应量之月度数据 | | 221 | us_tbr | [短期国债利率](references/宏观经济/国际宏观/美国利率/短期国债利率.md) | 宏观经济,国际宏观,美国利率 | 获取美国短期国债利率数据 | | 220 | us_trycr | [国债实际收益率曲线利率](references/宏观经济/国际宏观/美国利率/国债实际收益率曲线利率.md) | 宏观经济,国际宏观,美国利率 | 国债实际收益率曲线利率 | | 222 | us_tltr | [国债长期利率](references/宏观经济/国际宏观/美国利率/国债长期利率.md) | 宏观经济,国际宏观,美国利率 | 国债长期利率 | | 223 | us_trltr | [国债长期利率平均值](references/宏观经济/国际宏观/美国利率/国债长期利率平均值.md) | 宏观经济,国际宏观,美国利率 | 国债实际长期利率平均值 | | 219 | us_tycr | [国债收益率曲线利率](references/宏观经济/国际宏观/美国利率/国债收益率曲线利率.md) | 宏观经济,国际宏观,美国利率 | 获取美国每日国债收益率曲线利率 | | 420 | rt_idx_min | [指数实时分钟](references/指数专题/指数实时分钟.md) | 指数专题 | 获取交易所指数实时分钟数据，包括1~60min | | 419 | idx_mins | [指数历史分钟](references/指数专题/指数历史分钟.md) | 指数专题 | 获取交易所指数分钟数据，支持1min/5min/15min/30min/60min行情，提供Python SDK和 http Restful API两种方式 | | 215 | daily_info | [沪深市场每日交易统计](references/指数专题/沪深市场每日交易统计.md) | 指数专题 | 获取交易所股票交易统计，包括各板块明细 | | 211 | index_global | [国际主要指数](references/指数专题/国际主要指数.md) | 指数专题 | 获取国际主要指数日线行情 | | 181 | index_classify | [申万行业分类](references/指数专题/申万行业分类.md) | 指数专题 | 获取申万行业分类，可以获取申万2014年版本（28个一级分类，104个二级分类，227个三级分类）和2021年本版（31个一级分类，134个二级分类，346个三级分类）列表信息 | | 268 | sz_daily_info | [深圳市场每日交易情况](references/指数专题/深圳市场每日交易情况.md) | 指数专题 | 获取深圳市场每日交易概况 | | 128 | index_dailybasic | [大盘指数每日指标](references/指数专题/大盘指数每日指标.md) | 指数专题 | 目前只提供上证综指，深证成指，上证50，中证500，中小板指，创业板指的每日指标数据 | | 403 | rt_idx_k | [指数实时日线](references/指数专题/指数实时日线.md) | 指数专题 | 获取交易所指数实时日线行情，支持按代码或代码通配符一次性提取全部交易所指数实时日k线行情 | | 96 | index_weight | [指数成分和权重](references/指数专题/指数成分和权重.md) | 指数专题 | 获取各类指数成分和权重，**月度数据** ，建议输入参数里开始日期和结束日分别输入当月第一天和最后一天的日期。 | | 373 | ci_index_member | [中信行业成分](references/指数专题/中信行业成分.md) | 指数专题 | 按三级分类提取中信行业成分，可提供某个分类的所有成分，也可按股票代码提取所属分类，参数灵活 | | 358 | idx_factor_pro | [指数技术面因子(专业版)](references/指数专题/指数技术面因子(专业版).md) | 指数专题 | 获取指数每日技术面因子数据，用于跟踪指数当前走势情况，数据由Tushare社区自产，覆盖全历史；输出参数_bfq表示不复权描述中说明了因子的默认传参，如需要特殊参数或者更多因子可以联系管理员评估，指数包括大盘指数 申万行业指数 中信指数 | | 335 | index_member_all | [申万行业成分(分级)](references/指数专题/申万行业成分(分级).md) | 指数专题 | 按三级分类提取申万行业成分，可提供某个分类的所有成分，也可按股票代码提取所属分类，参数灵活 | | 417 | rt_sw_k | [申万实时行情](references/指数专题/申万实时行情.md) | 指数专题 | 获取申万行业指数的最新截面数据 | | 172 | index_monthly | [指数月线行情](references/指数专题/指数月线行情.md) | 指数专题 | 获取指数月线行情,每月更新一次 |