Tushare

Overview

Quick Start

• Install a Python runtime environment (Python 3.7+ is recommended), and install the tushare dependency package (installation from Tsinghua PyPI mirror is recommended).

pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple

• When running this Skill for the first time, or when the proxy configuration has not been confirmed available in the current session, you must complete a proxy check first; after the configuration is confirmed available in the same session, there is no need to repeat the check for subsequent queries.
• The configuration reading order is fixed as:
  1. Current process environment variables

  2. ~/.config/tushare-skills/env

• If any configuration is missing:
  1. Immediately interrupt the current task
  2. Clearly inform the user of the missing variable name
  3. Request the user to provide the missing value
  4. After receiving it, the agent directly writes it to

     ~/.config/tushare-skills/env

     in the fixed format of

     KEY=value

     , and sets the file permission to

     600

  5. Continue executing the data query after writing is completed
• If the configuration value exists:
  1. First inject the obtained

     TUSHARE_PROXY_TOKEN

     and

     TUSHARE_PROXY_URL

     into the process environment of the current execution command
  2. Directly execute the actual interface requested by the user
  3. If the actual interface returns authentication failure, connection failure or proxy address error, you must also interrupt immediately, request the user to provide the correct value, and overwrite

     ~/.config/tushare-skills/env

• Do not require users to manually execute initialization scripts.
• Do not expose real proxy addresses or real tokens in replies, logs, examples or repository documents.
• Query the Tushare interface documentation to find the corresponding interface. Online Data Interface Documentation
• Use Python code to obtain data according to the interface documentation. (e.g., Stock List interface)

import os
import tushare as ts

# Initialize the pro interface instance using proxy mode
pro = ts.pro_api("12345")
pro._DataApi__token = os.getenv("TUSHARE_PROXY_TOKEN", "")
pro._DataApi__http_url = os.getenv("TUSHARE_PROXY_URL", "")

# Query the data interface (*Stock List*) to get the list of listed trading stocks
df = pro.stock_basic(list_status='L', fields='ts_code,symbol,name,area,industry,list_date')
print(df)

pro.xxx(...)

Parameter Format Description

• Date: YYYYMMDD (e.g., 20241231)
• Stock code: ts_code format (e.g., 000001.SZ, 600000.SH)
• Return format: pandas DataFrame

Python Script Examples

• Stock Data Acquisition Example
• Fund Data Acquisition Example

Data Interface List