tushare-data_skill

Overview

This skill provides a Python client wrapper for the Tushare financial data service, exposing standardized APIs to fetch market and fundamental data. It centralizes access to stocks, funds, futures, crypto, macro indicators and company financials through simple function calls. The skill is designed for developers, quants, and analysts who need lightweight, scriptable access to a broad set of Chinese and global market datasets.

How this skill works

The skill initializes a Tushare pro API instance using a user-provided token and issues HTTP requests to Tushare endpoints. It normalizes endpoints into Python methods that return tabular data (Pandas-friendly), supporting query parameters such as date ranges, symbols, and field selection. The wrapper focuses on read-only data retrieval for market quotes, index components, macro series, and company fundamentals.

When to use it

• Building automated data pipelines for backtesting or research
• Rapidly prototyping market dashboards or data-driven reports
• Pulling historical and intraday quotes for quantitative strategies
• Extracting company financials and fund manager information for fundamental analysis
• Integrating macroeconomic and cross-asset indicators into models

Best practices

• Register for and securely store your Tushare token; set it via environment variable rather than hard-coding
• Use field filtering and date ranges to limit payload size and improve performance
• Cache frequent queries or persist results to avoid repeated API calls and rate limits
• Validate data types and handle missing values before feeding into models
• Respect the service rate limits and implement retry/backoff for transient errors

Example use cases

• Fetch a current list of actively traded stocks and their listing dates for universe construction
• Download historical daily OHLCV for backtesting a trading strategy
• Retrieve company income statements and balance sheets for fundamental signal generation
• Collect macro series (GDP, CPI, FX) to include as features in macro-driven models
• Aggregate ETF and fund data to monitor flows and holdings trends