🚀 快速开始
你只需要拿到管理员分发的 API Key，即可调用本服务开放的 Tushare Pro 数据接口。 学业论文、量化交易、股市盯盘、机器学习、策略模型等场景均可直接接入。
🧪 在线测试 API Key
你可以直接在这里输入 API Key 测试可用性。系统会调用 000001.SZ 最近一段时间的日线数据，并展示最新一条返回结果。
🚀 可查哪些数据？
请查看官方网页： https://tushare.pro/document/2?doc_id=290
📖 方式一：使用 Tushare SDK
如果你已经在用 tushare Python 包，只需改两行代码即可。 如果你之前设置过 token 环境变量，记得先删除，避免旧配置覆盖。
常规接口示例
import tushare as ts
# 把 token 设为管理员给你的 API Key
ts.set_token("*** 替换成你的 API Key ***")
# 修改 API 地址
pro = ts.pro_api()
pro._DataApi__http_url = "__BASE_URL__"
# 然后正常使用，和官方接口保持一致
df = pro.daily(ts_code="000001.SZ", start_date="20260101", end_date="20260110")
print(df)ts.pro_bar() 等模块级函数说明
形如 ts.pro_bar() 这类模块级函数，不是 pro 对象的方法， 必须额外手动传入 api=pro。
import tushare as ts
ts.set_token("*** 替换成你的 API Key ***")
pro = ts.pro_api()
pro._DataApi__http_url = "__BASE_URL__"
df = ts.pro_bar(
ts_code="002594.SZ",
api=pro,
start_date="20180101",
end_date="20181011",
adj="qfq",
)
print(df)📖 方式二：直接 HTTP 请求
直接向根路径 / 发送 POST 请求。 当前支持两种鉴权方式。
方式 A：Token 放在 Body（推荐）
import requests
resp = requests.post("__BASE_URL__", json={
"api_name": "daily",
"token": "*** 替换成你的 API Key ***",
"params": {
"ts_code": "000001.SZ",
"start_date": "20260101",
"end_date": "20260110"
}
})
data = resp.json()
print(data)方式 B：Token 放在 Header
import requests
resp = requests.post("__BASE_URL__", json={
"api_name": "daily",
"params": {
"ts_code": "000001.SZ",
"start_date": "20260101",
"end_date": "20260110"
}
}, headers={
"x-api-key": "*** 替换成你的 API Key ***"
})
data = resp.json()
print(data)方式 C：使用 curl
如果你只是想快速验证接口是否可用，用 curl 最直接。
curl 示例 A：Token 放在 Body
curl -X POST "__BASE_URL__" \
-H "Content-Type: application/json" \
-d '{
"api_name": "daily",
"token": "*** 替换成你的 API Key ***",
"params": {
"ts_code": "000001.SZ",
"start_date": "20260101",
"end_date": "20260110"
}
}'curl 示例 B：Token 放在 Header
curl -X POST "__BASE_URL__" \
-H "Content-Type: application/json" \
-H "x-api-key: *** 替换成你的 API Key ***" \
-d '{
"api_name": "daily",
"params": {
"ts_code": "000001.SZ",
"start_date": "20260101",
"end_date": "20260110"
}
}'| POST / 标准接口 | 位置 | 说明 |
|---|---|---|
| token | Body | 你的 API Key |
| api_name | Body | 接口名，如 daily、income |
| params | Body | 查询参数 |
| fields | Body | 返回字段，可选 |
| 两种鉴权方式 | 位置 | 说明 |
|---|---|---|
| x-api-key | Header | 你的 API Key |
| api_name | Body | 接口名 |
| params | Body | 查询参数 |
| fields | Body | 返回字段，可选 |
📋 支持的数据接口、权限、频次
支持所有 Tushare Pro 对应积分权限的数据接口。
⚠️ 注意事项
- 请勿泄露你的 API Key，若发生泄露请联系管理员重新分发。
- 频率限制默认约为 180 次/分钟，通常已经足够使用。
- Key 存在有效期，到期后请联系管理员续期。
- 返回格式与 Tushare 官方保持一致，无需额外处理。
🦞 OpenClaw 提示词
可以把下面这段说明直接给 OpenClaw 使用。
我有 15000 积分权限的 Tushare Pro 高权限调用 key，请你帮我采用 tushare sdk 的接口抓取数据。
注意代码必须参照如下方式设置代理：
import tushare as ts
ts.set_token("*** 替换成你的 API Key ***")
pro = ts.pro_api()
pro._DataApi__http_url = "__BASE_URL__"
df = pro.daily(ts_code="000001.SZ", start_date="20260101", end_date="20260110")
print(df)
注意：
形如 pro_bar 的接口传参时还要加 api=pro，例如：
df = ts.pro_bar(
ts_code="002594.SZ",
api=pro,
start_date="20180101",
end_date="20181011",
adj="qfq",
)
print(df)💡 常见问题
Q: 支持哪些接口？
支持 Tushare Pro 对应权限的数据接口。接口分为积分权限接口与独立权限接口，具体请参考官方说明和权限表。
Q: 和直接用 Tushare 有什么区别？
返回格式保持一致。你只需要把服务地址和 Token 替换掉，绝大多数代码无需改写。
Q: SDK 方式失败，但其他方式可以？
通常是旧 token 环境变量还在生效，请先删除环境变量后再试。
Q: 积分是什么？
积分不是消耗品，积分代表权限等级。你主要需要关注的是权限覆盖范围与有效期。
Q: 我的 Key 过期了怎么办？
联系管理员续期即可，通常无需修改代码。
Q: 为什么有些接口提示没权限？
有些接口属于独立权限，不包含在通用积分权限内。请以官方文档说明为准。 例如股票历史分钟行情： https://tushare.pro/document/2?doc_id=370
Q: 是否会限速？
默认限制约为 180 次/分钟，主要用于保护整体稳定性；如有特殊需求请联系管理员。
Q: 高峰期偶尔失败怎么办？
建议在客户端加重试逻辑。高峰期可能会有小概率波动，极高要求场景仍建议使用官方独占服务。
Q: 稳定性如何？
任何人都无法对稳定性做绝对承诺。我们会尽量快速处理波动，但对极端稳定性要求场景，仍建议优先考虑官方独占方案。
Q: 提示 token 不对怎么办？
先确认代理地址是否已改为 __BASE_URL__。 对于 pro_bar 等模块级函数，还要确认是否补了 api=pro。
Q: OpenClaw 报 token 无效或没权限？
通常是地址没改对，或者漏了 api=pro。请明确要求它使用本文档里的接入方式。
Q: OpenClaw 查的数据不全？
可以把对应的 Tushare 官方接口文档链接发给它，让它基于官方说明补充上下文。
Q: OpenClaw 昨天还能用，今天又忘了？
现阶段 AI 工具可能会遗忘配置。可以再次强调必须使用本页的代理地址和 SDK 改法，并让它写入记忆。