1. 项目概述
Financial-API 是 HiThink 官方推出的 A 股（中国内地股票市场）金融数据服务，为 AI 智能体、量化研究者和应用开发者提供统一的数据获取方式，用于查询实时与历史行情、财务报表、估值、指数、板块以及公募基金信息，无需再拼凑多个数据供应商。
2. 背景与定位
HiThink（同花顺）是中国主要的金融数据与交易软件提供商，本项目将其内部行情数据基础设施通过开发者友好、标准化的接口开放出来。核心目标是让一个 API 密钥即可驱动所有访问方式——REST 调用、面向 AI 聊天工具的 MCP 服务器、用于脚本编写的 CLI、用于研究笔记本的 Python SDK，以及开箱即用的 Agent Skill——这样团队就不必为每种使用场景分别编写和维护独立的集成。
与常见的开源金融数据封装项目不同，它的突出特点是以 AI 智能体为先的设计：开箱即附带可安装的 Agent Skill 和原生 MCP 支持，明确避免在 LLM 工作流中使用模拟数据和上下文溢出，并且专注深入地聚焦于中国 A 股市场，而不是泛泛地覆盖全球交易所。
3. 功能分类
📈 行情数据——实时报价、K 线（蜡烛图）历史、成交量和集合竞价快照。例如：最新价格查询、盘中逐笔数据、历史日线/分钟线、盘前集合竞价快照。
📊 财务报表与估值——用于分析和筛选的公司基本面数据。例如：利润表、资产负债表、现金流量表、估值比率（市盈率、市净率、市销率、市现率）。
🔥 特色市场指标——A 股市场交易机制所特有的数据。例如：涨停/跌停池、炸板跟踪、市场异动、热门股票列表、龙虎榜（顶级交易者）排名。
🏦 指数与板块——用于宏观和主题分析的分组市场视图。例如：指数成分股、板块表现、板块轮动数据。
💰 公募基金与 ETF——与股票并列的基金侧数据。例如：基金持仓、历史基金业绩、ETF/LOF 市场报价。
🗄️ 本地数据基础设施——用于离线、大规模分析的工具。例如：全市场数据集下载、通过 marketdb 构建本地 DuckDB 数据库、对本地存储的行情数据进行 SQL 查询。
4. 核心亮点
- 七种访问方式，一个 API 密钥——Skill、MCP、REST API、CLI、Python SDK、marketdb 和直接 JSON API 均使用同一个统一的
HITHINK_FINANCE_API_KEY进行认证。 - 原生 MCP 支持——可直接连接 Claude Desktop、Cursor 和 Windsurf，让 AI 助手以对话方式查询金融数据。
- 可安装的 Agent Skill——通过一条命令
npx skills add安装后，编码智能体即可获得统一接口，并自动为给定请求选择正确的后端。 - 本地 DuckDB 集成（
marketdb）——支持构建和查询持久化本地数据库，便于反复回测而无需频繁请求远程 API。 - 无模拟数据政策——服务在数据不可用时会明确报告，而不是编造数值，这对研究和交易相关的工作流至关重要。
- 深度 A 股专业化——涨停池和龙虎榜排名等指标体现了对中国市场微观结构的深入理解，而非泛泛的全球股票封装。
5. 按角色的使用场景
通用开发者——通过 REST API 将股票报价、财务数据或基金数据集成到 Web/移动应用中，无需从零搭建数据管道。
数据与研究科学家/量化研究者——使用 Python SDK 和 marketdb 拉取历史数据、构建本地 DuckDB 数据集，并直接在笔记本中运行回测或因子研究。
AI/智能体构建者——安装 Agent Skill 或配置 MCP 服务器，让基于 LLM 的智能体能够利用实时数据回答金融问题或自动执行研究任务。
6. 快速开始
找到你需要的内容——在文档中心浏览 REST API 契约和指南：
https://fuyao.aicubes.cn/docs/
安装与集成——选择适合你工作流的访问方式：
# AI 智能体/编码助手集成
npx skills add HiThink-Tech/Financial-API --skill hithink-finance -g --yes
# 命令行工具
npm install -g @hithink-tech/hithink-finance-cli
hithink-finance auth login
# Python SDK
python -m pip install -e ./python
请先在 https://fuyao.aicubes.cn/admin/ 注册统一 API 密钥，并将其设置为 HITHINK_FINANCE_API_KEY 环境变量。
参与贡献——仓库采用 monorepo 结构组织；在 GitHub 上提交拉取请求之前，请先查阅文档和各包专属的 README（hithink-finance-cli/README.md、python/README.md、skills/hithink-finance/SKILL.md）。
7. 项目结构
docs/ API 契约和中央文档中心
api/ REST API 契约源文件
skills/
hithink-finance/ 可安装的 Agent Skill（统一契约）
hithink-finance-cli/ Node.js CLI，独立于 Python SDK
python/
marketdb/ 用于离线查询的本地 DuckDB 接口
toolkit/fuyao/ 远程数据客户端和辅助脚本
examples/ 可执行的用法示例
tests/ 测试套件
examples/ 额外的灵感展示和静态示例
scripts/ 仓库维护工具
8. 相关生态
Financial-API 与模型上下文协议（MCP）集成，可直接在 Claude Desktop、Cursor 和 Windsurf 中使用。它基于 DuckDB 通过 marketdb 模块实现本地数据存储。底层数据平台托管在 fuyao.aicubes.cn，该站点同时提供 API 密钥管理控制台和完整文档站点。
9. 许可证
✅ 在 MIT 许可证下可自由使用、复制、修改、合并、发布和分发，包括用于商业产品。
✅ 可嵌入专有或闭源应用程序中。
❌ 不提供任何担保；作者不对因使用本项目造成的损害承担责任。
ℹ️ 访问底层金融数据仍需 HiThink API 密钥，并受 HiThink 自身 API 服务条款约束，与代码本身的 MIT 许可证相互独立。
ℹ️ 本服务明确不构成投资建议——输出内容不应被视为财务建议。
10. 常见问题
问：每种集成方式（REST、CLI、MCP 等）都需要单独的 API 密钥吗？
答：不需要——在 https://fuyao.aicubes.cn/admin/ 获取的单个 HITHINK_FINANCE_API_KEY 即可用于全部七种访问方式。
问：构建 AI 智能体应该使用哪种访问方式？
答：使用 Agent Skill（npx skills add HiThink-Tech/Financial-API --skill hithink-finance -g --yes）以获得统一接口；如果你直接在 Claude Desktop、Cursor 或 Windsurf 中工作，则使用 MCP 服务器。
问：我可以将数据存储在本地，而不必每次都调用 API 吗？
答：可以——使用 Python SDK 中的 marketdb 模块构建本地 DuckDB 数据库，并对其运行 SQL 查询。
问：这个服务仅限于中国 A 股，还是覆盖全球市场？
答：该服务专注聚焦于中国 A 股市场，包括涨停/跌停池和龙虎榜排名等市场特有指标。
问：如果请求的数据不可用会怎样？
答：服务会明确报告数据不可用，而不是返回模拟或编造的值。
11. 快速链接
- 仓库：https://github.com/HiThink-Tech/Financial-API
- 文档中心：https://fuyao.aicubes.cn/docs/
- API 密钥管理：https://fuyao.aicubes.cn/admin/
- 网站：https://fuyao.aicubes.cn/
12. 总结
Financial-API 将 HiThink 的 A 股市场数据基础设施封装为单一、认证方式一致的服务，开发者、量化研究者和 AI 智能体都可以以适合自己的格式使用——REST、CLI、Python、MCP 或即插即用的 Agent Skill。对于构建中国金融市场应用或 AI 研究智能体的团队来说，它的价值最大，因为这些团队需要可靠、结构良好的数据，而不必拼凑多个供应商。