Tushare Pro · 高性能数据网关

学术量化 · 策略研发 · 实时行情 · AI 智能体部署

1. 温馨提示

本接口仅用于学习研究,商用请支持官方。适用于学术论文撰写、量化交易开发、股市实时盯盘、机器学习训练、交易策略建模等场景,助力高效挖掘数据内在价值。
市场有风险,入市需谨慎,一切投资行为风险自行承担。
如果您有龙虾OpenClaw 🦞,爱马仕Hermes 也可以把文末提示词发给AI,让AI帮您部署。

2. SDK调用 (推荐 · 最简接入)

如果您已经在用 tushare Python 包,只需修改两行代码。⚠️ 如果之前设置过token环境变量请先删除。

import tushare as ts

# 把 token 设为管理员给您的 API Key
ts.set_token("这里请替换为您的key")

# 修改 API 地址
pro = ts.pro_api()
pro._DataApi__http_url = "http://jiaoch.site"

# 然后正常使用
df = pro.daily(ts_code='000001.SZ', start_date='20260101', end_date='20260110')
print(df)

特殊情形:模块级函数 ts.pro_bar() 必须手动传参 api=pro

import tushare as ts

ts.set_token("这里请替换为您的key")
pro = ts.pro_api()
pro._DataApi__http_url = "http://jiaoch.site"

# 注意 api=pro 参数
df = ts.pro_bar(ts_code='002594.SZ', api=pro, start_date='20180101', end_date='20181011', adj='qfq')
print(df)

3. HTTP直调 (通用RESTful)

💡 重要!requests 库默认启用 gzip 压缩。其他语言请设置 Accept-Encoding: gzip 请求头以获得更快的响应速度。

方式 A:Token 放在 Body(推荐)

import requests

resp = requests.post("http://jiaoch.site", json={
    "api_name": "daily",
    "token": "这里请替换为您的key",
    "params": {
        "ts_code": "000001.SZ",
        "start_date": "20260101",
        "end_date": "20260110"
    }
})
print(resp.json())

方式 B:Token 放在 Header

import requests

resp = requests.post("http://jiaoch.site", json={
    "api_name": "daily",
    "params": {"ts_code": "000001.SZ","start_date": "20260101","end_date": "20260110"}
}, headers={"x-api-key": "这里请替换为您的key"})
print(resp.json())

Body鉴权参数

参数说明
token您的 API Key
api_name接口名 (daily/income等)
params查询参数字典
fields返回字段(可选)

Header鉴权参数

Header说明
x-api-key您的 API Key
其余参数放 JSON Body

4. 限速与冷却机制

并发过高会触发冷却:少量超速只返回报错;大幅超速触发3-10分钟冷却,期间无法请求(程序表现为超时)。
代码中请设置合理速度,建议 每次请求间隔≥0.5秒。AI调用时务必明确指示限速。
极个别接口官方自带极低限额(如每日2次),不在积分范围内,请以官方文档为准,代码中加入重试。

5. TradingAgents 集成指南

TradingAgents:无图形界面,推荐让龙虾部署并配置数据获取方式。
TradingAgents-CN v1.0.1:有界面但存在硬编码,需手动修改后端。以下为修改要点(仅限v1.0.1研究):

文件1: tradingagents/dataflows/providers/china/tushare.py(4处)
每处 self.api = ts.pro_api() 后增加:
self.api._DataApi__http_url = "http://jiaoch.site"

文件2: app/services/config_service.py(1处)第1294行:
pro._DataApi__http_url = "http://jiaoch.site"

Web UI 设置:API Key填完整Token,Endpoint填写 http://jiaoch.site(仅供展示,实际以后端修改为准)

6. MCP (Model Context Protocol) 配置

被誉为AI世界的USB-C接口,一行配置让AI自主调用数据。

Claude Desktop

{
  "mcpServers": {
    "tushare": {
      "command": "npx",
      "args": ["-y","mcp-remote@latest","http://jiaoch.site/mcp/token=您的key","--allow-http","--transport","http-only"]
    }
  }
}

Cursor

URL: http://jiaoch.site/mcp/token=您的key

VS Code (Copilot)

{
  "servers": {
    "tushare": {
      "type": "streamable-http",
      "url": "http://jiaoch.site/mcp/token=您的key"
    }
  }
}

配置后直接在对话中:“查一下000001.SZ最近一周日线行情” → AI自动调用接口返回数据。

7. OpenClaw / 爱马仕 提示词

⚠️ 注意:AI有时会遗忘设置,请再次发送提示词或让它将方法记入记忆。

我有15000积分权限的tushare pro高权限调用key,请您帮我采用 tushare sdk 的接口抓取数据
注意代码要参照形如如下修改部分代码设置代理:
import tushare as ts
ts.set_token("这里替换key")
pro = ts.pro_api()
pro._DataApi__http_url = "http://jiaoch.site"
# 模块级接口需加 api=pro
df = ts.pro_bar(ts_code='002594.SZ', api=pro, start_date='20180101', end_date='20181011', adj='qfq')
请把当前方法记入记忆中,抓取15000积分内数据用于分析。

8. 支持接口 & 积分权限

支持所有 Tushare Pro 对应积分权限接口(10000积分权限 + 部分独立接口按需)。

积分权限对照表:https://tushare.pro/document/1?doc_id=290
积分权限明细表:查看详细积分列表

查询具体接口是否可用:官方接口文档搜索 | 右上角文本框输入接口名

能不能查 xxx 数据?
打开 https://tushare.pro/document/2 ,右上角搜索查看是否属于10000积分或独立接口范围。

9. 注意事项

🔒 冷却恢复
暴力超速会导致3-10分钟冷却,程序超时报错,冷却后自动恢复,请设置合理并发。
⏱️ 稳定性声明
我们力求稳定但不保证100%无波动,极致稳定性要求建议支持官方服务。
🔄 高峰期延迟
少量时段响应可能变慢,属于正常现象,高要求场景推荐官方企业版。
🧪 独立权限接口
部分接口(如分钟行情)需单独开通,不在通用积分范围,请提前确认。

10. 常见问题

Q: 和官方Tushare数据格式有区别吗?

A: 完全一致,只需替换服务地址和Token。

Q: 积分会消耗吗?

A: 积分代表权限等级,不消耗,仅需留意有效期。

Q: 调用提示无权限?

A: 部分接口需要“单独开通”(如历史分钟数据),不属于15000积分范围,请查阅官方权限说明。

Q: 程序阶段性超时?

A: 几乎都是因为超速触发冷却,检查是否超过200次/分钟,调整限速等待冷却结束。

Q: SDK方式失败但HTTP可用?

A: 请检查是否设置了Tushare环境变量,删除环境变量后重试。

Q: 龙虾OpenClaw报token无效?

A: 确认key有效前提下,让AI务必加上 pro._DataApi__http_url = "http://jiaoch.site" 以及特殊接口的 api=pro 参数;若AI遗忘,重新发送提示词并让它存入记忆。

Q: 数据不全?

A: 把官方接口文档链接发给龙虾,让它学习接口定义并存入记忆。

Q: 您的token不对,请确认?

A: 代理设置遗漏,比如模块级接口少了 api=pro,见上文SDK示例。