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.