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
积分权限明细表:查看详细积分列表
查询具体接口是否可用:官方接口文档搜索 | 右上角文本框输入接口名
打开 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示例。