Tushare Data Retrieval

Task Objectives

• This Skill is used to: Obtain A-share market data, financial indicators and macroeconomic data through the Tushare data interface
• Capabilities include: Real-time market quotes, historical K-lines, financial data, indicator data, stock information, macroeconomic data, index data
• Trigger conditions: When users mention Tushare or need to obtain A-share data, financial information, or macroeconomic data

Preparations

• Dependency description: Install the tushare library (included in dependencies)
• Credential configuration: Need to configure Tushare Token (credential name: TUSHARE_TOKEN, environment variable: TUSHARE_TOKEN)
• Account application: Visit https://tushare.pro/ to register an account and obtain API Token (see references/tushare_quickstart.md for details)

Operation Steps

• Standard process:
  1. Determine data requirements — The agent understands the user's intent (market quotes/K-lines/finance/macro/index, etc.)
  2. Call the corresponding script — Select the script based on data type
  3. Parse results — The agent analyzes the returned JSON format data
• Script call mapping:
  • Market quotes/K-lines/adjacent data →

    python scripts/market_data.py --type daily --ts_code 000001.SZ --start_date 20240101 --end_date 20240131

  • Financial data/income statement/balance sheet →

    python scripts/financial_data.py --type financial --ts_code 000001.SZ --period 2023

  • Stock list/trading calendar →

    python scripts/stock_info.py --type stock_basic

  • Index data/macroeconomic data →

    python scripts/macro_index_data.py --type index_daily --ts_code 000001.SH --start_date 20240101 --end_date 20240131

• Optional branches:
  • When needing data for multiple stocks: Use the --ts_code parameter separated by commas
  • When needing adjusted data: Use the --type adj_factor to obtain adjustment factors
  • When needing to specify a reporting period: Use the --period parameter (YYYY or YYYYMM)

Usage Examples

• Example 1: Obtain daily K-line data of stocks
  • Scenario/Input: User says "Check the K-line data of Ping An Bank in the last month"
  • Expected output: Return OHLCV data such as date, opening price, highest price, lowest price, closing price, trading volume, etc.
  • Key points: Call

    python scripts/market_data.py --type daily --ts_code 000001.SZ --start_date 20240301 --end_date 20240331

• Example 2: Query financial data
  • Scenario/Input: User says "Obtain the financial indicators of China Merchants Bank in 2023"
  • Expected output: Return financial indicators such as ROE, ROA, gross profit margin, net profit margin, etc.
  • Key points: Call

    python scripts/financial_data.py --type fina_indicator --ts_code 600036.SH --period 2023

• Example 3: Obtain index data
  • Scenario/Input: User says "Query the recent trend of the Shanghai Composite Index"
  • Expected output: Return data such as date, closing price, trading volume of the Shanghai Composite Index
  • Key points: Call

    python scripts/macro_index_data.py --type index_daily --ts_code 000001.SH --start_date 20240301 --end_date 20240331

Resource Index

• Scripts:
  • scripts/market_data.py (Purpose and parameters: Obtain market quotes/K-lines/adjusted data, supports --type/--ts_code/--start_date/--end_date)
  • scripts/financial_data.py (Purpose and parameters: Obtain financial data/income statement/balance sheet/cash flow statement/indicators, supports --type/--ts_code/--period)
  • scripts/stock_info.py (Purpose and parameters: Obtain stock list/trading calendar/name changes, supports --type/--ts_code/--start_date/--end_date)
  • scripts/macro_index_data.py (Purpose and parameters: Obtain index data/macroeconomic data/Shibor, supports --type/--ts_code/--start_date/--end_date)
• References:
  • references/tushare_quickstart.md (When to read: During initial configuration or authentication failure)
  • references/api_reference.md (When to read: When needing to view detailed API parameter descriptions)

Notes

• Script execution requires configuring Tushare Token, complete credential configuration first for initial use
• Tushare stock code format: Shanghai market is XXXXXX.SH, Shenzhen market is XXXXXX.SZ
• Some data (such as financial data) may have delays, it is recommended to obtain it outside the trading hours of 9:30-15:00 on trading days
• Scripts return data in JSON format, the agent is responsible for parsing and converting it into user-friendly display
• There are call frequency limits, free accounts can make up to 120 calls per minute (see Tushare official documentation for details)
• It is recommended to read tushare_quickstart.md first to complete authentication configuration for initial use