与 AkShare / TuShare 对比¶
这页回答两个问题:
- 这套接口文档和
AkShare、TuShare到底有什么区别? - 如果之后公开,会不会有人需要?
先说结论¶
这三者不是同一层的产品:
AkShare更像 Python 数据采集与研究工具箱。TuShare更像带账号、权限和配额体系的数据服务平台。- 你这套文档站对应的是“标准化接口消费层”,强调 HTTP / WSS 接入、统一鉴权、统一返回、统一错误码和公开可读的文档体验。
换句话说,AkShare / TuShare 更偏“拿数据”,你这套更偏“把数据服务产品化并对外说明清楚”。
对比表¶
| 维度 | 你的接口文档 / 接口平台 | AkShare | TuShare |
|---|---|---|---|
| 产品形态 | 面向外部调用方的 HTTP / WSS 接口文档站 | Python 财经数据接口库 | 数据服务平台,支持 HTTP 与多语言 SDK |
| 主要使用者 | 前端、移动端、后端集成方、第三方合作方 | Python 研究者、量化开发者、数据分析人员 | Python 用户、量化团队、研究人员、需要标准数据平台的用户 |
| 接入方式 | 直接按接口地址、参数、状态码接入 | 先安装 Python 库,再调用函数 | 先注册账号,拿 Token,再通过 HTTP 或 SDK 调用 |
| 是否适合非 Python 团队 | 很适合 | 一般。官方明确以 Python 为核心,虽提到 AKTools 面向非 Python 用户,但主形态仍是 Python 库 |
适合。官方明确提供 HTTP 与多语言获取方式 |
| 实时推送 | 有,文档里已覆盖 WSS 场景 | 官方文档重点是函数式数据获取,公开资料里我没看到以 WSS 为核心的接入模型 | 官方公开资料重点是 HTTP / SDK 拉取式接口 |
| 文档阅读门槛 | 低。打开即读,不需要登录 | 中。先理解安装、函数名、返回 DataFrame | 中。需要先理解账号、Token、积分/权限 |
| 鉴权与权限 | 你可自定义为统一签名体系,对外规则一致 | 多数接口直接在 Python 内调用;部分外部数据源需要各自 API Key | 官方采用 Token + 权限体系,部分接口需要达到积分门槛或单独开权限 |
| 数据组织方式 | 你可以把多个底层来源整理成一个统一出口 | 官方强调从公开站点获取原始数据,并持续维护采集接口 | 官方强调 Pro 版具备自有数据生产、存储和治理体系 |
| 返回结构 | 可统一成固定 JSON 结构和标准错误码 | 以 Python 返回结果为主,风格随接口而异 | 官方 HTTP 接口返回结构统一,包含 code、msg、data |
| 对外公开展示 | 很适合做公开文档与合作接入页 | 更适合开发者自己查函数文档 | 更适合登录后按权限使用,不是“无门槛公开浏览型”文档体验 |
| 对业务方最友好的点 | 一次看清 URL、参数、认证、示例代码、状态码、WSS | 免费、覆盖广、上手快、适合 Python 研究探索 | 数据治理更平台化,权限、频次、接口边界更明确 |
| 最可能卡住的点 | 需要你自己维护网关稳定性与文档同步 | 依赖 Python 运行环境和上游公开站点变化 | 依赖账号、Token、积分/权限与服务协议限制 |
对公开发布有没有价值¶
有,而且用户画像很明确。
最可能需要这套文档的人¶
- 需要直接对接 HTTP / WSS 的前端团队
- 用 Java、Go、PHP、Node.js 做服务接入的后端团队
- 不想研究 Python SDK,只想按标准接口接入的人
- 需要给客户、合作方、代理商、内部其他团队做统一说明的人
- 想先看清返回结构、错误码和认证方式,再决定是否接入的人
不一定最需要的人¶
- 只在本地做 Python 回测和研究的个人用户
- 已经深度依赖
AkShare或TuShare原生生态的研究型用户 - 更关心原始数据源函数,而不是统一 API 出口的人
为什么这套文档公开后仍然成立¶
因为你公开的不是“某个 Python 函数怎么调用”,而是:
- 一个可以直接消费的接口协议
- 一套稳定的字段和错误码约定
- 一套适合产品化展示的接入说明
- 一个对非 Python 用户友好的统一入口
这类内容在合作接入、销售演示、客户试用、团队协作里都比单纯源码文档更有用。
适合公开时强调的卖点¶
如果你后面要公开,可以优先强调这几点:
- 无登录即可阅读,降低试用门槛
- 统一 HTTP / WSS 接口,不绑具体编程语言
- 统一鉴权、统一错误码、统一返回结构
- 直接提供
cURL、Python、JavaScript、PHP示例 - 兼顾行情、板块、策略、监控与推送场景
使用边界¶
这页对 AkShare 和 TuShare 的描述,基于我在 2026 年 8 月 1 日查阅的官方资料做的对比整理。涉及权限、频次、价格、协议限制时,应以它们各自官网最新说明为准。