# Tushare

Tushare是一个财经数据接口包，拥有丰富的数据内容，如股票、基金、期货、数字货币等行情数据，公司财务、基金经理等基本面数据。该模块通过标准化API方式统一了数据资产的对外服...

- Repository: https://github.com/HKUDS/Vibe-Trading (37375 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add HKUDS/Vibe-Trading --skill tushare -g -a claude-code -y`
Codex: `npx skills add HKUDS/Vibe-Trading --skill tushare -g -a codex -y`
Cursor: `npx skills add HKUDS/Vibe-Trading --skill tushare -g -a cursor -y`
Gemini CLI: `npx skills add HKUDS/Vibe-Trading --skill tushare -g -a gemini-cli -y`

## Description

tushare是一个财经数据接口包，拥有丰富的数据内容，如股票、基金、期货、数字货币等行情数据，公司财务、基金经理等基本面数据。该模块通过标准化API方式统一了数据资产的对外服务方式，以帮助有需要的技术用户更实时、简洁、轻量的使用相关数据。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Tushare

## 概述

tushare是一个财经数据接口包，拥有丰富的数据内容，如股票、基金、期货、数字货币等行情数据，公司财务、基金经理等基本面数据。该模块通过标准化API方式统一了数据资产的对外服务方式，以帮助有需要的技术用户更实时、简洁、轻量的使用相关数据。

## 快速上手

- 安装python运行环境(推荐python3.7+)，并安装tushare依赖包(推荐从清华pypi镜像安装)。

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

- Tushare官网注册，获取token，并配置环境变量。 [注册地址](https://tushare.pro/register)

```bash
export TUSHARE_TOKEN=your_token
```

- 查询Tushare接口文档，找到对应的接口。 [在线数据接口文档](https://tushare.pro/document/2)
- 根据接口文档，使用python代码获取数据。（如**股票列表**接口）

```python
import os
import tushare as ts

# 读取环境变量中的token, 或者读取本地记录的token
token = os.getenv('TUSHARE_TOKEN') or ts.get_token()

# 初始化pro接口实例
pro = ts.pro_api(token)

# 查询数据接口（*股票列表*），获取上市交易的股票列表
df = pro.stock_basic(list_status='L', fields='ts_code,symbol,name,area,industry,list_date')
print(df)
```

## 参数格式说明

- 日期：YYYYMMDD（如 20241231）
- 股票代码：ts_code 格式（如 000001.SZ, 600000.SH）
- 返回格式：pandas DataFrame

> 链接约定：本文档内所有指向 `references/` 的链接均以 **相对本文档** 的形式书写（如 `references/...`），这是 GitHub 在浏览器中打开该文件时解析的形式。`read_file` 工具会把同一字符串解析到拥有它的技能目录下，因此人和 agent 读到的是同一份文件。新增技能文档时务必沿用相对形式，并保证 references 路径在各技能之间不重名：两个技能同时拥有的路径会被报为歧义，而不会被猜测。

## python脚本示例

- [股票数据获取示例](scripts/stock_data_example.py)
- [基金数据获取示例](scripts/fund_data_example.py)

## 数据接口列表

The rest: https://github.com/HKUDS/Vibe-Trading/blob/HEAD/agent/src/skills/tushare/SKILL.md