推荐下同花顺官方API

之前写了一篇同花顺问财 如何把问财skill变成python代码 ，额度有限。 周末群里同学在聊同花顺官方API， 我试用了下感觉不错，推荐给大家。

一、这是一个什么项目?

Financial-API 是同花顺官方推出的 A 股(及公募基金)金融数据服务的统一接入仓库。它不是一个简单的接口文档,而是一整套覆盖"取数—分析—建库"全链路的工具集。

一句话概括:一个 API Key,四种接入方式,覆盖你能想到的所有 A 股常用数据。

它面向三类核心人群:

• AI Agent 开发者 —— 让大模型在对话中直接调取金融数据;
• 量化研究员 —— 批量下载、回测、用 Python/SQL 搞研究;
• 应用开发者 —— 把行情、财务数据接进自己的网站或 App。

而最让我惊喜的,是它的数据覆盖广度,远超一般"免费接口"的体量。

二、数据覆盖:该有的全都有

很多人担心开源/免费数据"只有行情没有深度"。这个项目基本打消了这个顾虑。它的数据矩阵是这样的:

行情与价格

• 全市场实时行情快照(最新价、涨跌额、涨跌幅、开高低、成交量、成交额)
• 历史日 K 线、除权除息、前复权/后复权因子

财务与估值

• 三大报表:资产负债表、利润表、现金流量表
• 五大类财务指标
• 估值快照:PE(TTM/MRQ)、PB(MRQ)、PS(TTM)、PCF(TTM)

市场结构

• 指数、板块及其成分股、相关历史行情
• 交易日历、标的目录、股票名称/代码检索

特色数据(这是亮点)

• 涨停板池、连板梯队
• 盘中异动、热度排行
• 龙虎榜

公募基金

• 基金资料、披露持仓、净值、收益、持有人结构、ETF/LOF 快照

当然,它也明确说了不包含的内容:分钟级 K 线、Tick 数据、海外行情、宏观数据、新闻和研报。

三、四大接入方式:总有一款适合你

这是这个项目最值得称道的设计。同一份数据,它给了你四种姿势去拿,真正做到"按需取用"。

1️⃣ REST API —— 最通用

零依赖、语言无关,任何能发 HTTP 请求的环境都能用。一行 curl 就能拿到茅台的最新行情

返回标准的 JSON 信封结构,业务码、request_id、时间戳一应俱全,非常适合接入企业系统或做网站后端。

2️⃣ MCP —— AI 时代的新玩法

这是我觉得最"与时俱进"的部分。项目提供了 4 个托管的 MCP(Model Context Protocol)服务端点,可以直接接入 Claude Desktop、Cursor、Windsurf 这些 AI 客户端:

• A 股
• :/mcp/a-share —— 行情、财报、特色数据
• A 股指数
• :/mcp/a-share-index —— 指数、板块
• 元数据
• :/mcp/meta —— 标的检索、能力发现
• 基金
• :/mcp/fund —— 基金净值、ETF 数据

配好之后,你直接在对话里问"帮我看看今天涨停的股票",AI 就会自动调用接口帮你查。对做 AI 金融助手的同学来说,这是开箱即用的基础设施。

3️⃣ Python SDK —— 量化的主场

为 Jupyter Notebook、研究脚本、定时取数而生,能丝滑对接 pandas、NumPy 和各类回测框架

4️⃣ CLI 命令行 —— 人机两用

基于 Node.js 的 hithink-finance-cli,把远程取数、本地建库、鉴权、JSON 格式化统一到一个入口,既方便人手敲,也方便 AI Agent 程序化调用:

四、为什么我觉得它值得推荐?

客观说几点我的判断:

1. 数据权威,来源可靠。 背靠同花顺,数据质量和更新及时性有保障,比来路不明的爬虫强太多。

2. 接入方式全,场景覆盖广。 从一行 curl 到 AI 对话,从 Python 到本地 SQL,几乎覆盖了所有技术栈和使用场景。

3. 对 AI 时代友好。 原生支持 MCP,这在当前一众金融数据服务里是稀缺的。做 AI 金融 Agent 的人会非常受用。

4. 设计专业。 统一的 API Key、规范的响应信封、清晰的错误码、DuckDB 本地化方案——能看出是认真做过工程的团队。

当然也有需要了解的点: 具体的数据权限、调用频率限制以官网授权为准,分钟级和 Tick 等高频数据暂不支持。如果你的需求是高频交易或日内策略,这块要提前确认。

五、怎么上手?

三步走:

1. 拿 Key
2. :到同花顺金融数据服务官网,在 API Key 管理里创建一个统一密钥(四种接入方式共用)。
3. 存好 Key
4. :推荐设为环境变量 HITHINK_FINANCE_API_KEY,或用 CLI 的 hithink-finance auth login 安全登录。
5. 挑姿势开跑
6. :文档、示例代码、SDK、CLI 全在仓库里,照着 README 抄就能跑通。

项目地址:

https://gitee.com/HiThink-Tech/Financial-API

文档地址：

https://fuyao.aicubes.cn/docs/