核心用法
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 是中文金融数据获取的可靠基础设施,适合对数据质量有要求、能接受权限分层模式的专业用户。