tushare-base

📊 中国A股期货专业数据一站获取

专业级中国A股/期货市场数据接口,覆盖股票、期货、宏观经济全品类数据,需Tushare Token授权使用。

收藏
9.1k
安装
2.8k
版本
1.0.0
CLS 安全性认证2026-05-06
点击查看完整报告 >

使用说明

核心用法

Tushare Skill 是面向中国金融市场的专业数据获取工具,通过官方 Tushare Pro API 提供 A 股、期货及宏观数据查询服务。核心功能模块包括:

股票数据:支持全市场股票基础信息检索(stock_basic)、日/周/月多周期行情(daily/weekly/monthly)、实时行情快照(realtime)、个股资金流向(moneyflow)及公司基本面信息(company)。股票代码需遵循交易所后缀格式,如 000001.SZ(深主板)、600519.SH(沪主板)、688001.SH(科创板)。

期货数据:覆盖中金所、上期所、大商所、郑商所、能源中心五大交易所,提供合约基础信息(fut_basic)、日线行情(fut_daily)及持仓排名数据(fut_holding)。期货代码格式如 CU.SHF(沪铜)、IF.CFX(沪深300期指)。

宏观经济:内置 GDP、CPI、PPI 等关键指标查询,输出格式化增长数据便于趋势分析。

所有命令通过 python3 scripts/market.py 统一入口调用,支持日期范围、交易所筛选等参数。

显著优点

1. 数据权威性:直接对接 Tushare 官方数据源,覆盖中国资本市场核心数据品类
2. 多周期支持:股票行情支持日/周/月线及实时数据,满足不同分析场景

3. 统一接口设计:单一脚本入口,参数规范一致,降低学习成本

4. 期货全市场覆盖:五大交易所合约数据完整,含持仓排名等专业字段

5. 宏观经济集成:GDP/CPI/PPI 等数据直接可查,无需跨平台获取

潜在缺点与局限性

1. 权限分层:Tushare 采用积分制,部分高频数据或历史数据需积累积分或付费开通
2. 环境依赖:需提前配置 TUSHARE_TOKEN 环境变量,增加部署复杂度

3. 实时性边界:"实时行情"实际为快照数据,非逐笔成交流;Level-2 行情需更高权限

4. 代码格式严格:股票/期货代码必须带交易所后缀(如 .SZ/.SHF),不支持纯数字代码智能识别

5. 无数据可视化:仅返回原始数据表格,需用户自行接入分析工具

适合人群

  • 量化研究者:需要结构化 A 股/期货历史数据用于策略回测
  • 基本面分析师:查询公司信息、资金流向及宏观经济指标
  • 个人投资者:获取多周期行情数据辅助投资决策
  • 金融开发者:将数据接口集成至自有交易系统或监控工具

常规风险

| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 数据权限中断 | 积分耗尽或 Token 失效导致接口拒绝服务 | 定期监控积分余额,设置 Token 轮换机制 |
| 行情延迟 | 实时数据存在分钟级延迟,不适合高频交易 | 明确数据时效边界,延迟敏感场景选用 Level-2 付费接口 |
| 代码格式错误 | 未正确添加交易所后缀导致查询失败 | 使用 `stock_basic`/`fut_basic` 先查标准代码表 |
| 环境变量泄露 | Token 硬编码或日志泄露 | 使用专用 secrets 管理工具,避免提交至版本控制 |

该 Skill 是中文金融数据获取的可靠基础设施,适合对数据质量有要求、能接受权限分层模式的专业用户。

安全解读

核心功能

Tushare 是中国领先的金融数据平台,该 Skill 提供完整的 Python 接口,覆盖 A 股全市场、期货品种及宏观经济指标的数据获取能力。核心功能包括:

  • 股票数据:日线/周线/月线行情、实时报价、资金流向、公司基本面
  • 期货数据:上期所、大商所、郑商所、中金所合约行情与持仓排名
  • 宏观指标:GDP、CPI、PPI 等经济数据的程序化获取

显著优点

数据权威性:直接对接 Tushare 官方 API,数据源覆盖上交所、深交所、各期货交易所,数据质量有保障
接口标准化:统一的股票代码格式(如 000001.SZ、CU.SHF),支持多种时间粒度查询

功能完整性:不仅包含行情数据,还提供资金流向、持仓排名等深度数据

技术成熟度:依赖 pandas 进行数据处理,符合量化分析行业标准

潜在局限性

访问门槛:需注册 Tushare 账号并获取 API Token,部分高级接口需积分或付费
网络依赖:必须连接 Tushare 官方服务器,无法离线使用

数据延迟:免费版存在数据延迟,实时行情需更高权限

地域限制:主要服务中国市场,境外用户可能面临网络连通性问题

适合人群

  • 量化投资研究者与交易员
  • 金融数据分析从业者
  • 学术研究人员(金融、经济领域)
  • 个人投资者进行数据驱动决策

常规风险提示

合规使用:金融数据仅限个人研究学习,商业用途需遵守 Tushare 服务条款
Token 安全:API Token 需妥善保管,避免泄露导致账户被滥用

数据验证:重要决策前应交叉验证数据准确性,不宜单一依赖

服务连续性:第三方服务存在变更可能,建议关注官方公告

tushare-base 内容

references文件夹
scripts文件夹
手动下载zip · 9.3 kB
futures_api.mdtext/markdown
请选择文件