Tushare 数据插件
Tushare 插件通过 Tushare Pro API 获取 A 股、港股和美股的历史日线与实时行情数据。Tushare Pro 是国内广泛使用的金融数据开放平台,需要注册账号并获取 Token 后使用。
支持的市场
| 市场 | 搜索 | 实时价格 | 历史日线 | 说明 |
|---|---|---|---|---|
| A 股 | 代码 + 名称 | 盘中价(需积分) / 最近收盘价 | 支持高低价 | 覆盖沪深北三市 |
| 港股 | 代码 + 名称 | 盘中价(需积分) / 最近收盘价 | 支持高低价 | 港股通标的 |
| 美股 | 代码 + 名称 | 最近收盘价 | 支持高低价 | 主要美股 |
配置
在 设置 → 插件管理 → Tushare 中填写 Tushare Token(必填),保存后插件会自动检测 Token 对应的权限和能力。
Token 获取方式:
- 访问 tushare.pro 注册账号。
- 登录后进入"个人主页 → 接口 Token",复制 Token。
- 粘贴到 WealthSight 插件设置中。
Tushare 积分与权限说明
Tushare Pro 采用积分体系控制 API 调用权限,不同接口需要不同积分门槛。以下为与 WealthSight 使用相关的核心接口清单:
免费注册即可使用的接口(120 积分)
| 接口 | 用途 | WealthSight 对应功能 |
|---|---|---|
stock_basic | A 股股票列表 | 标的搜索(名称匹配) |
daily | A 股日线行情 | 历史价格、收盘价 |
注册 Tushare 即赠送 120 积分(完成手机绑定等基本资料可再获得少量积分),刚好覆盖 A 股的基础搜索和历史数据。
需要更多积分的接口
| 接口 | 最低积分 | 用途 | WealthSight 对应功能 |
|---|---|---|---|
hk_basic | 2000 | 港股股票列表 | 港股标的搜索 |
hk_daily | 2000 | 港股日线行情 | 港股历史价格 |
us_basic | 2000 | 美股股票列表 | 美股标的搜索 |
us_daily | 2000 | 美股日线行情 | 美股历史价格 |
rt_k | 视等级而定 | A 股实时分钟行情 | A 股盘中价格 |
rt_hk_k | 视等级而定 | 港股实时分钟行情 | 港股盘中价格 |
积分获取方式
| 方式 | 积分 | 说明 |
|---|---|---|
| 注册账号 | 120 | 完成注册即送 |
| 完善个人信息 | 20 | 绑定手机号等 |
| 社区发帖/回复 | 少量 | 参与 Tushare 社区讨论 |
| 文档贡献 | 100~200 | 为 Tushare 文档做贡献 |
| 捐赠/付费 | 按金额 | 快速获取大量积分 |
建议:如果只需要 A 股数据,注册即可免费使用。如需港股、美股数据,建议通过捐赠快速达到 2000 积分门槛,或使用其他数据源(如本地文件插件导入 akshare 导出数据)。
能力检测
配置 Token 后,可以在插件管理页面点击 重新检测能力,查看当前 Token 在 A 股、港股、美股三个市场的实际可用情况。检测结果会显示各市场的搜索、最新价格和历史数据的具体能力等级。
搜索标的
Tushare 插件支持按 代码 或 名称 搜索标的:
- A 股代码格式:支持
000001、000001.SZ、SZ000001、sh600519等多种写法,插件自动识别市场。 - 港股代码格式:支持
00700、00700.HK等写法,自动补齐 5 位。 - 美股代码格式:使用标准 ticker,如
AAPL、MSFT。
搜索时优先匹配代码(精确 > 前缀),其次匹配中文名称。A 股标的名称搜索依赖 stock_basic 接口的本地缓存(24 小时有效),首次使用时会自动拉取。
获取价格
- A 股盘中价格:如果 Token 有
rt_k接口权限,可获取当日盘中价格。否则回退到最近交易日收盘价。 - 港股盘中价格:需要
rt_hk_k接口权限。 - 美股价格:返回最近交易日收盘价。
- 价格时间:盘中价返回当日时间,收盘价返回最近交易日日期。
获取历史数据
历史日线数据支持指定日期范围,返回包含开盘以来的高低价和收盘价:
- A 股:通过
daily接口获取,支持复权数据。 - 港股:通过
hk_daily接口获取。 - 美股:通过
us_daily接口获取。
单次请求返回指定日期范围内的全部日线数据。如果 Token 未开通对应市场接口,该市场的历史数据功能将不可用。
注意事项
- Tushare Pro 由第三方独立运营,其服务可用性、数据准确性、积分政策和接口权限由 Tushare 平台自行决定。WealthSight 不保证 Tushare API 的稳定性和数据质量。
- 请合理控制请求频率。插件内置了 250ms 最小请求间隔和最多 2 次自动重试,但仍建议避免短时间内大量查询。
- Token 是敏感凭据,请勿分享给他人。插件设置中使用密码框存储 Token。
- 如果 Token 丢失或泄露,请在 Tushare 网站重新生成。
- Tushare Pro 的积分政策和接口权限可能随时调整,请以 tushare.pro 官网最新公告为准。
- 使用本插件即表示您已知悉:数据来自 Tushare Pro,WealthSight 仅作为数据消费方提供集成便利。