✓ Verified 🌐 Web Scrapers ✓ Enhanced Data

Tushare Base

Fetch Chinese stock and futures market data via Tushare API.

Rating: 4.2 (51 reviews)
Downloads: 36,431 downloads
Version: 1.0.0

Overview

Fetch Chinese stock and futures market data via Tushare API.

Complete Documentation

View Source →

Tushare 金融数据接口

获取中国 A 股市场和期货市场的实时及历史数据。

前提条件

1. 注册 Tushare 账号

访问 https://tushare.pro/register 注册账号并获取 API Token。

2. 配置 Token

bash

# 添加到 ~/.zshrc
export TUSHARE_TOKEN="your-api-token-here"

然后执行：

bash

source ~/.zshrc

3. 安装依赖

bash

pip3 install tushare pandas --user

快速开始

获取股票列表

bash

python3 scripts/market.py stock_basic

获取日线行情

bash

python3 scripts/market.py daily --ts_code 000001.SZ --start_date 20240101 --end_date 20240131

获取实时行情

bash

python3 scripts/market.py realtime 000001

股票数据

股票基础信息

bash

python3 scripts/market.py stock_basic
python3 scripts/market.py stock_basic --exchange SSE  # 仅上交所
python3 scripts/market.py stock_basic --exchange SZSE  # 仅深交所

日线行情

bash

# 获取单只股票近期数据
python3 scripts/market.py daily --ts_code 000001.SZ

# 指定日期范围
python3 scripts/market.py daily --ts_code 600519.SH --start_date 20240101 --end_date 20240131

# 获取指定交易日全市场数据
python3 scripts/market.py daily --trade_date 20240115

周线行情

bash

# 获取周线数据
python3 scripts/market.py weekly --ts_code 000001.SZ

# 指定日期范围
python3 scripts/market.py weekly --ts_code 600519.SH --start_date 20230101 --end_date 20240131

月线行情

bash

# 获取月线数据
python3 scripts/market.py monthly --ts_code 000001.SZ

# 指定日期范围
python3 scripts/market.py monthly --ts_code 600519.SH --start_date 20200101 --end_date 20240131

股票代码格式：

深交所：000001.SZ, 000002.SZ, 300001.SZ (创业板)
上交所：600000.SH, 600519.SH, 688001.SH (科创板)

实时行情

bash

python3 scripts/market.py realtime 000001
python3 scripts/market.py realtime 600519

资金流向

bash

# 获取指定股票资金流向
python3 scripts/market.py moneyflow --ts_code 000001.SZ

# 获取指定日期全市场资金流向
python3 scripts/market.py moneyflow --trade_date 20240115

公司信息

bash

python3 scripts/market.py company

期货数据

期货合约基础信息

bash

python3 scripts/market.py fut_basic

# 指定交易所
python3 scripts/market.py fut_basic --exchange CFFEX  # 中金所
python3 scripts/market.py fut_basic --exchange SHFE   # 上期所
python3 scripts/market.py fut_basic --exchange DCE    # 大商所
python3 scripts/market.py fut_basic --exchange CZCE   # 郑商所

交易所代码：

CFFEX - 中国金融期货交易所
SHFE - 上海期货交易所
DCE - 大连商品交易所
CZCE - 郑州商品交易所
INE - 上海国际能源交易中心

期货日线行情

bash

# 获取铜期货数据
python3 scripts/market.py fut_daily --ts_code CU.SHF

# 获取沪深300股指期货
python3 scripts/market.py fut_daily --ts_code IF.CFX

# 指定日期范围
python3 scripts/market.py fut_daily --ts_code RB.SHF --start_date 20240101 --end_date 20240131

期货代码格式：

上期所：CU.SHF (铜), RB.SHF (螺纹钢), AU.SHF (黄金)
大商所：M.DCE (豆粕), I.DCE (铁矿石)
郑商所：SR.CZC (白糖), CF.CZC (棉花)
中金所：IF.CFX (沪深300), IC.CFX (中证500)

期货持仓排名

bash

python3 scripts/market.py fut_holding --trade_date 20240115 --symbol CU

宏观经济

GDP 数据

bash

python3 scripts/market.py gdp

输出示例：

text

📈 GDP数据 (88 条):

2023年4季度: GDP 347909亿元, 增速 5.2%
2023年3季度: GDP 319992亿元, 增速 4.9%
...

CPI 数据

bash

python3 scripts/market.py cpi

PPI 数据

bash

python3 scripts/market.py ppi

命令速查表

命令	功能	示例
stock_basic	股票基础信息	--exchange SSE
daily	日线行情	--ts_code 000001.SZ --start_date 20240101
weekly	周线行情	--ts_code 000001.SZ --start_date 20230101
monthly	月线行情	--ts_code 000001.SZ --start_date 20200101
realtime	实时行情	000001
moneyflow	资金流向	--ts_code 000001.SZ
company	公司信息	-
fut_basic	期货基础信息	--exchange SHFE
fut_daily	期货日线	--ts_code CU.SHF
fut_holding	持仓排名	--symbol CU
gdp	GDP数据	-
cpi	CPI数据	-
ppi	PPI数据	-

常见问题

错误：请设置 TUSHARE_TOKEN 环境变量 → 在 ~/.zshrc 中添加 export TUSHARE_TOKEN="your-token" 并执行 source ~/.zshrc

错误：没有数据返回 → 检查股票/期货代码格式是否正确（如：000001.SZ, CU.SHF）

错误：权限不足 → Tushare 部分接口需要积分或付费权限，请在官网查看接口权限要求

如何获取股票代码？

bash

python3 scripts/market.py stock_basic | grep "平安"

参考文档

股票接口文档: references/stock_api.md
期货接口文档: references/futures_api.md
Tushare 官网: https://tushare.pro

Installation

Terminal bash


openclaw install tushare-base

Copied!

💻Code Examples

pip3 install tushare pandas --user

pip3-install-tushare-pandas---user.txt

## 快速开始

### 获取股票列表

python3 scripts/market.py realtime 000001

python3-scriptsmarketpy-realtime-000001.txt

## 股票数据

### 股票基础信息

python3 scripts/market.py monthly --ts_code 600519.SH --start_date 20200101 --end_date 20240131

python3-scriptsmarketpy-monthly---tscode-600519sh---startdate-20200101---enddate-20240131.txt

**股票代码格式**：
- 深交所：`000001.SZ`, `000002.SZ`, `300001.SZ` (创业板)
- 上交所：`600000.SH`, `600519.SH`, `688001.SH` (科创板)

### 实时行情

python3 scripts/market.py company

python3-scriptsmarketpy-company.txt

## 期货数据

### 期货合约基础信息

python3 scripts/market.py fut_basic --exchange CZCE # 郑商所

python3-scriptsmarketpy-futbasic---exchange-czce--.txt

**交易所代码**：
- `CFFEX` - 中国金融期货交易所
- `SHFE` - 上海期货交易所
- `DCE` - 大连商品交易所
- `CZCE` - 郑州商品交易所
- `INE` - 上海国际能源交易中心

### 期货日线行情

python3 scripts/market.py fut_daily --ts_code RB.SHF --start_date 20240101 --end_date 20240131

python3-scriptsmarketpy-futdaily---tscode-rbshf---startdate-20240101---enddate-20240131.txt

**期货代码格式**：
- 上期所：`CU.SHF` (铜), `RB.SHF` (螺纹钢), `AU.SHF` (黄金)
- 大商所：`M.DCE` (豆粕), `I.DCE` (铁矿石)
- 郑商所：`SR.CZC` (白糖), `CF.CZC` (棉花)
- 中金所：`IF.CFX` (沪深300), `IC.CFX` (中证500)

### 期货持仓排名

python3 scripts/market.py fut_holding --trade_date 20240115 --symbol CU

python3-scriptsmarketpy-futholding---tradedate-20240115---symbol-cu.txt

## 宏观经济

### GDP 数据

python3 scripts/market.py ppi

python3-scriptsmarketpy-ppi.txt

## 命令速查表

| 命令 | 功能 | 示例 |
|------|------|------|
| `stock_basic` | 股票基础信息 | `--exchange SSE` |
| `daily` | 日线行情 | `--ts_code 000001.SZ --start_date 20240101` |
| `weekly` | 周线行情 | `--ts_code 000001.SZ --start_date 20230101` |
| `monthly` | 月线行情 | `--ts_code 000001.SZ --start_date 20200101` |
| `realtime` | 实时行情 | `000001` |
| `moneyflow` | 资金流向 | `--ts_code 000001.SZ` |
| `company` | 公司信息 | - |
| `fut_basic` | 期货基础信息 | `--exchange SHFE` |
| `fut_daily` | 期货日线 | `--ts_code CU.SHF` |
| `fut_holding` | 持仓排名 | `--symbol CU` |
| `gdp` | GDP数据 | - |
| `cpi` | CPI数据 | - |
| `ppi` | PPI数据 | - |

## 常见问题

**错误：请设置 TUSHARE_TOKEN 环境变量**
→ 在 `~/.zshrc` 中添加 `export TUSHARE_TOKEN="your-token"` 并执行 `source ~/.zshrc`

**错误：没有数据返回**
→ 检查股票/期货代码格式是否正确（如：000001.SZ, CU.SHF）

**错误：权限不足**
→ Tushare 部分接口需要积分或付费权限，请在官网查看接口权限要求

**如何获取股票代码？**

example.sh

python3 scripts/market.py stock_basic
python3 scripts/market.py stock_basic --exchange SSE  # 仅上交所
python3 scripts/market.py stock_basic --exchange SZSE  # 仅深交所

example.sh

# 获取单只股票近期数据
python3 scripts/market.py daily --ts_code 000001.SZ

# 指定日期范围
python3 scripts/market.py daily --ts_code 600519.SH --start_date 20240101 --end_date 20240131

# 获取指定交易日全市场数据
python3 scripts/market.py daily --trade_date 20240115