- Financial-API(仓库名 hithink-finance)是同花顺官方维护的 A 股金融数据服务,GitHub 仓库采用 MIT 协议,2026 年 6 月 9 日创建,截至 2026 年 9 月 7 日 Star 数为 2,671。
- 一个 API Key 打通六种接入方式:REST API、托管 MCP、命令行工具、Python SDK、本地 DuckDB 数据库和 Agent Skill。
- 数据覆盖 A 股实时行情、历史日 K、财务报表、估值、公募基金,以及涨跌停池、炸板池、个股异动、热榜、龙虎榜等盘口数据;分钟 K、tick、港美股行情、宏观数据、新闻与研报原文在公开范围之外。
- 官方没有公布定价页和 QPS 数字,承诺不设累计调用次数上限,限流策略由服务端动态调整。
- 第三方实测发现文档与接口行为存在出入:错误码定义与实际返回不一致,历史热榜接口被用户质疑数据重复,接入后建议用一只标的做完整验证。
同花顺金融数据API是什么
想给 AI Agent 接上 A 股数据,过去的选项有三类:akshare 这类爬虫库,网页结构一变,脚本失效;tushare,积分制,高频字段要付费;Wind、iFinD 这类终端,一年数万元起。2026 年 6 月,同花顺官方在 GitHub 放出 Financial-API,走的是第四条路:官方维护的数据服务,配一个 API Key,向 AI Agent、量化脚本和业务系统开放。
输入输出链路一句话说清:你对 Agent 说一句「查一下贵州茅台的最新行情和最近四期利润表」,Agent 调用它返回结构化 JSON,含价格、涨跌幅、报告期和数据时间。开源的是接入层代码——CLI、Python SDK、Agent Skill,MIT 协议;数据服务本身是带鉴权的在线服务,数据权限以官网和账号授权为准。
官方身份这一点值得单独验证,金融数据接口是假官网重灾区。这个 GitHub 账号 2026 年 6 月 9 日注册,没有简介,名下有一个仓库,单看页面不像大公司出品。科技媒体 TechMoon 做过一轮身份核验:官网 fuyao.aicubes.cn 的 TLS 证书签给 *.10jqka.com.cn,证书主体为 Hithink RoyalFlush Information Network Co.,Ltd.(浙江杭州),而 10jqka.com.cn 是同花顺主域名;npm 官方包的发布者邮箱挂在 myhexin.com 企业域名下;官网「开源社区」菜单链向 GitHub 仓库,仓库 README 链回官网。三条证据指向同一结论:这是同花顺官方项目,不是套壳站。
为 AI Agent 做的四层设计
第一层是 Skill。一行命令 npx skills add HiThink-Tech/Financial-API 把使用说明装进 Claude Code 等支持 Skill 的工具,Agent 读取后自行判断当前任务该走 API、MCP、CLI 还是 Python SDK。仓库内置 AGENTS.md,规定 Agent 取数时的行为:股票名称消歧成唯一代码,大结果落盘,真实数据不可用时说明原因,不用模拟数据冒充。 第二层是写给模型看的文档。官网提供 llms.txt 和 llms-full.txt,后者把全站文档和接口契约打包成纯文本,方便大模型一次读入。金融数据服务把模型当成文档读者,这个做法少见。
第三层是响应协议。业务响应包括错误在内,外层保持 HTTP 200,结果靠信封内的 code 字段区分;字段统一 snake_case,时间戳用毫秒。官方文档写明理由:减少模型解析歧义。代价是调用方的监控和重试逻辑不能依赖 HTTP 状态码,要解开信封看 code。
第四层是行为条款。Skill 文件要求 Agent 不把 Key 写进代码、对话或日志,全市场级的大结果写入本地文件、对话里回路径和摘要,不回数据本体,分析输出标注数据来源和「非投资建议」。数据商把反捏造条款写进产品文档,说明它预期的第一用户是模型,不是人。
数据能力:有什么,没有什么
行情侧有实时快照、集合竞价快照和历史日 K,历史 K 线一次查一只标的,上限十年,粒度到日线。基本面有利润表、资产负债表、现金流量表和五类财务指标,估值快照覆盖市盈率 TTM 与 MRQ、市净率、市销率、市现率。公募基金覆盖资料、公司、经理、披露持仓、业绩、净值和 ETF/LOF 场内行情。特色盘口数据有涨跌停池、炸板池、连板天梯、个股异动、热榜和龙虎榜。大用量场景走 CLI 下载全市场数据文件,或者用 marketdb 在本地建 DuckDB 库,支持增量同步、SQL 查询和前复权视图。
有两处口径以端点契约为准,不看宣传页:官网总览页宣称支持周线月线,端点契约写明当前支持日线;集合竞价快照、当日个股异动等三项能力当日限定,过期查不到。
范围之外的有:分钟 K、tick、港美股行情、宏观经济数据、新闻公告原文、研报原文。交易功能同样没有,GitHub issue #48 有人询问能否下单查持仓,官方回复不在产品定位内。做日内策略或海外市场的读者,这个项目满足不了。
快速上手:从申请 Key 到跑通第一次查询
前置条件:Node.js 环境(CLI 用)、Python 环境(SDK 用)、一个同花顺账号。
第一步,申请 Key。登录官网 fuyao.aicubes.cn,进入「API Key 管理」页签发 Key,格式以 sk-fuyao 开头。REST API、MCP、CLI、Python 共用同一个 Key,官方推荐存为用户级环境变量 HITHINK_FINANCE_API_KEY。
第二步,安装 CLI:
国内网络可加镜像参数:
第三步,录入 Key 并盘点能力:
capabilities 输出能力目录,这条命令不依赖 Key,未申请也能跑。TechMoon 实测 2026 年 9 月初的版本列出 69 项能力,其中远端 56 项、本地数据库操作 13 项。申请 Key 之前跑一遍,能确认你要的数据在不在目录里。
第四步,用一只标的做完整验证:
成功的标志:snapshot 返回 JSON,含最新价、涨跌幅、成交额和数据时间。
第五步(可选),接入 MCP 客户端。Claude Desktop、Cursor、Windsurf 等客户端在配置文件里挂四个托管端点,用 X-api-key 请求头鉴权: 常见失败有三种。返回信封 code 为 2003 且 message 是「Missing X-api-key」,说明请求头没带 Key;message 是「Invalid or revoked API key」,说明 Key 失效,到官网删除后重建;Windows 下 CLI 显示 Key 配置完成、REST 调用返回 2003,对应 issue #45,截至 2026 年 9 月 7 日未有官方修复结论,遇到时换环境验证或跟踪该 issue。
上手前要知道的四个坑
坑一,文档与接口行为对不上。文档错误码表定义 2001 为未认证、2003 为权限不足,TechMoon 实测发现缺 Key 和无效 Key 返回的结果同为 2003。照文档写的判断式分类错误会判错,排错要看 message 字段,不能凭 code 分类。
坑二,限流和定价不透明。全站没有定价页,没有免费额度说明,没有 QPS 数字。issue #37 有用户撞到 429 后询问限流标准,官方回复未给数字,建议降频后重试。「不设累计调用次数上限」的准确含义是:不计总量,速率上限由服务端动态调整。要接进商业产品的团队,动手前向官方问清授权和计费条款。
坑三,特色数据用之前要抽验。issue #55 有用户批量查询 185 个交易日的历史热榜,每天返回同一份 30 只股票名单,与另一个排名接口的结果对不上,截至 2026 年 9 月 7 日官方未回复。热榜、异动、龙虎榜是这套服务的差异化数据,依赖之前抽验几个历史日期。
坑四,海外连通性不稳。服务部署在中国移动网络,TechMoon 从台湾同一条线路连续请求五次,两次在 15 秒处超时。一次性查询受影响有限,排程任务和生产环境要把重试、超时和 429 退避写成默认逻辑,正式接入前在自己的网络环境抽测几天可达率。走 MCP 路线的读者留意 issue #40:prompts/list 响应的类型规格与严格客户端预期不符,官方回复处理中。
适合谁,不适合谁
适合的人:需要稳定、结构化的 A 股行情、财报和基金数据喂给 Agent 或量化流程的开发者与研究者;能接受境内节点连通性、愿意自己处理重试的团队。推荐接入顺序:CLI 盘点能力,申请 Key,单标的验证,进入正式流程。
绕道的人:需要分钟级以下数据、港美股行情或现成选股信号的人。它是数据层,不含投资建议功能;把数据接口当投顾用,路子从第一天起是错的。需要书面商用授权的团队,在官方公布条款之前保持观望。
行动清单
- 装 CLI 跑 capabilities。确认目标数据在能力目录里,去申请 Key;不在目录里,换数据源,别急着注册。
- 拿到 Key 用一只标的走完整查询来回,验证鉴权、字段和错误处理。
- 把重试、超时和 429 退避写进默认逻辑,判断成败看信封内的 code,不看 HTTP 状态码。
- 依赖热榜、龙虎榜等特色数据之前,抽验几个历史日期,与其他接口交叉比对。
- 商用接入前向官方确认授权条款与计费方式,没有书面承诺不做量产接入。