tushare

Access Chinese financial and macroeconomic datasets via the Tushare API.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/DaddyElonMusk69/motis-agent --skill tushare-daddyelonmusk69
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tushare
Source: https://github.com/DaddyElonMusk69/motis-agent/tree/main/skills/finance/tushare
Command: npx skills add https://github.com/DaddyElonMusk69/motis-agent --skill tushare-daddyelonmusk69

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tushare, pandas, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Tushare consolidates many Chinese financial and market datasets behind a standardized API, removing the friction of finding, authenticating, and fetching time-series, fundamental, and alternative market data from multiple sources. This Skill documents the endpoints, shows concrete Python examples, and helps users configure token-based access so they can programmatically retrieve data without manual web scraping or fragmented APIs.

Core Features & Use Cases

  • Comprehensive data coverage: access stock lists, daily and minute-level market data, ETFs, funds, bonds, futures, options, macroeconomic indicators, and curated news and policy corpora.
  • Python-first examples: runnable example scripts (stock_data_example.py, fund_data_example.py) that demonstrate token setup, pro_api initialization, and common queries returning pandas DataFrames.
  • Practical scenarios: quantitative research backtests, portfolio monitoring, fund holdings extraction, macro event analysis, and newsroom or model-training data collection.

Quick Start

Install the tushare package, set your TUSHARE_TOKEN environment variable, and run the provided stock_data_example.py to fetch sample stock and financial data.

Frequently Asked Questions about tushare

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch Chinese stock market data using Python?

To fetch Chinese stock market data using Python, use the Tushare API to programmatically retrieve time-series and fundamental datasets. It returns results directly as pandas DataFrames for analysis.

What financial datasets are available through the Tushare API?

The Tushare API provides comprehensive Chinese financial datasets including stock lists, daily market data, ETFs, funds, bonds, futures, options, and macroeconomic indicators.

Do I need an API token to access Tushare market data?

Yes, you need an API token to access Tushare market data. You must configure your TUSHARE_TOKEN environment variable and use pro_api initialization to make authenticated requests.

Can I use pandas DataFrames for quantitative research backtesting with Tushare?

Yes, you can use pandas DataFrames for quantitative research backtesting with Tushare. The API returns standardized DataFrames directly from endpoints like daily and stock_basic, ready for strategy development.

What's the best way to extract fund holdings and macroeconomic data for Python workflows?

The best way to extract fund holdings and macroeconomic data for Python workflows is using the Tushare API. It provides endpoints like fund_nav for batch data extraction tasks without manual web scraping.

Why should I use Tushare instead of scraping fragmented Chinese financial APIs?

You should use Tushare instead of scraping fragmented APIs because it consolidates many Chinese financial datasets behind a standardized, token-based interface, removing the friction of manual web scraping.