tushare-finance
stanleychanh/tushare-finance-skill-for-claude-code
Access 220+ Chinese financial market APIs for stocks, indices, funds, and macroeconomic data.
What is tushare-finance?
Tushare Finance provides real-time and historical data for Chinese A-shares, Hong Kong stocks, US stocks, funds, futures, and bonds via 220+ Tushare Pro interfaces. Use it when you need stock prices, financial statements, index data, or macroeconomic indicators like GDP and CPI.
- Query stock daily prices and historical data for A-shares, Hong Kong, and US markets
- Retrieve financial statements including income statements and financial indicators (ROE, etc.)
- Access index daily data for major Chinese indices
- Fetch fund net value data and performance metrics
- Obtain macroeconomic indicators including GDP, CPI, and other economic data
- Support 220+ data interfaces organized across 7 categories (stocks, indices, funds, futures, macro, HK/US stocks, bonds)
How to install tushare-finance
npx skills add https://github.com/stanleychanh/tushare-finance-skill-for-claude-code --skill tushare-finance- Tushare Pro account (register at https://tushare.pro)
- Tushare API token obtained from your account
- Python environment with tushare and pandas libraries installed
- Environment variable TUSHARE_TOKEN set with your token
How to use tushare-finance
- 1.Register for a Tushare Pro account at https://tushare.pro and obtain your API token
- 2.Set the environment variable: export TUSHARE_TOKEN="your_token"
- 3.Verify dependencies by running: python -c "import tushare, pandas; print('OK')" (install with pip if needed)
- 4.Import tushare and initialize the API: import tushare as ts; pro = ts.pro_api()
- 5.Call the appropriate interface method (e.g., pro.daily(), pro.fina_indicator(), pro.gdp()) with required parameters
- 6.Retrieve results as pandas DataFrame and process as needed
Use cases
- Analyze historical stock prices and trading volumes for investment research
- Compare financial metrics across companies using income statements and financial indicators
- Track macroeconomic trends using GDP, CPI, and other official statistics
- Monitor fund performance and net asset values over time
- Build datasets for quantitative analysis and backtesting trading strategies
- Financial analysts and researchers
- Investment professionals and traders
- Data scientists building financial models
- Economists analyzing macroeconomic trends
- Anyone needing Chinese market financial data
tushare-finance FAQ
Dates must be in YYYYMMDD format (e.g., 20241231 for December 31, 2024).
Use the ts_code format, such as 000001.SZ for Shenzhen stocks or 600000.SH for Shanghai stocks.
Visit https://tushare.pro to register a free account and generate your API token from your account dashboard.
Tushare provides 220+ interfaces across 7 categories: stocks (39), indices (18), funds (11), futures/options (16), macroeconomic (10), HK/US stocks (23), and bonds (16).
All API calls return data as pandas DataFrames, which can be easily filtered, analyzed, and exported.
Full instructions (SKILL.md)
Source of truth, from stanleychanh/tushare-finance-skill-for-claude-code.
name: tushare-finance description: 获取中国金融市场数据（A股、港股、美股、基金、期货、债券）。支持220+个Tushare Pro接口：股票行情、财务报表、宏观经济指标。当用户请求股价数据、财务分析、指数行情、GDP/CPI等宏观数据时使用。 allowed-tools:
- Bash(python:*)
- Read
Tushare 金融数据 Skill
本 skill 通过 Tushare Pro API 获取中国金融市场数据，支持 220+ 个数据接口。
快速开始
1. Token 配置
询问用户：是否已配置 Tushare Token？
如未配置，引导用户：
- 访问 https://tushare.pro 注册
- 获取 Token
- 配置环境变量：
export TUSHARE_TOKEN="your_token"
2. 验证依赖
检查 Python 环境：
python -c "import tushare, pandas; print('OK')"
如报错，安装依赖：
pip install tushare pandas
常用接口速查
| 数据类型 | 接口方法 | 说明 |
|---|---|---|
| 股票列表 | pro.stock_basic() | 获取所有股票列表 |
| 日线行情 | pro.daily() | 获取日线行情数据 |
| 财务指标 | pro.fina_indicator() | 财务指标（ROE等） |
| 利润表 | pro.income() | 利润表数据 |
| 指数行情 | pro.index_daily() | 指数日线数据 |
| 基金净值 | pro.fund_nav() | 基金净值数据 |
| GDP数据 | pro.gdp() | 国内生产总值 |
| CPI数据 | pro.cpi() | 居民消费价格指数 |
完整接口列表：查看 接口文档索引
数据获取流程
- 查找接口：根据需求在 接口索引 找到对应接口
- 阅读文档：查看
reference/接口文档/[接口名].md了解参数 - 编写代码：
import tushare as ts # 初始化（使用环境变量中的 Token） pro = ts.pro_api() # 调用接口 df = pro.daily(ts_code='000001.SZ', start_date='20241201', end_date='20241231') - 返回结果：DataFrame 格式
参数格式说明
- 日期：YYYYMMDD（如 20241231）
- 股票代码：ts_code 格式（如 000001.SZ, 600000.SH）
- 返回格式：pandas DataFrame
接口文档参考
接口索引：reference/README.md
接口文档按类别组织：
- 股票数据（39 个接口）
- 指数数据（18 个接口）
- 基金数据（11 个接口）
- 期货期权（16 个接口）
- 宏观经济（10 个接口）
- 港股美股（23 个接口）
- 债券数据（16 个接口）
参考资源
- Tushare 官方文档：https://tushare.pro/document/2
- API 测试工具：https://tushare.pro/document/1
Related skills
More from stanleychanh/tushare-finance-skill-for-claude-code and the wider catalog.
us-value-investing
US stock value investing analysis framework. Systematically evaluates listed companies through 4 core dimensions (ROE sustainability, debt safety, free cash flow quality, economic moat assessment), outputting investment ratings and analytical reasoning. This skill should be used when users mention topics such as whether a US stock is worth holding long-term, fundamental analysis of a company, ROE analysis, debt ratio assessment, free cash flow, economic moat, Buffett-style stock picking, value investing screening, how to read a company's financial reports, whether a stock's valuation is reasonable, etc. Even if users simply ask something general like "What do you think of stock XX?" or "Help me analyze XX's fundamentals," this skill should be triggered to provide a structured value investing analysis framework.
agent-hooks
Manage shell hooks to block, rewrite, or warn on agent actions at lifecycle points.
agentx
Post to the Starchild AgentX community forum—share projects, comments, likes, and follow other agents.
browser-preview
Diagnose and manage preview panel issues: registry, ports, paths, and running services.
byok-custom-model
Register custom LLM endpoints with your own API key for direct vendor access.
chart
Generate interactive web charts (line, bar, candlestick, scatter) with HTML and PNG export.