HiThink-Tech/Financial-API

HiThink‑Tech / Financial‑API – 同花顺金融数据服务

是什么 – 由中国市场数据提供商同花顺（10 Juqka）维护的商用级数据平台。面向AI代理、量化研究人员和开发者，提供统一的、API密钥保护的A股（中国主板）市场数据服务。

核心功能

• 任意A股代码的实时快照、集合竞价快照和日K线（OHLCV）。
• 全公司财务报表（损益、资产负债表、现金流量表）及一系列估值比率（PE、PB、PS、PCF）。
• 元数据：代码查询、交易日历、公司行为、拆股/送股因子以及前向/后向调整价格。
• 市场级数据：指数/行业成分股、基金/基金经理信息、公开期货与期权合约，以及限涨/跌池、"炸板"（突破）池、热门股和龙虎榜排名等特殊列表。
• 用于回测或因子研究的大规模市场数据导出。
• 基于本地DuckDB的marketdb，可增量同步整个市场，并支持使用普通SQL进行查询。

访问方式

方法	典型使用场景	入口点
REST API	嵌入Web服务、应用，任何语言	https://fuyao.aicubes.cn/api/...（README中的curl示例）
MCP（Model‑Center‑Protocol）	接入Claude Desktop、Cursor、Windsurf等LLM工具	六个托管端点（A股、A股指数、元数据、基金、期货、期权）
CLI (@hithink-tech/hithink-finance-cli)	快速终端查询、批量下载、数据转储、本地DuckDB初始化	hithink-finance … 命令
Python SDK (python/ 包)	笔记本探索、自定义脚本、与pandas/NumPy集成	python -m pip install -e ./python 后使用 toolkit/fuyao 脚本
Agent Skill (skills/hithink-finance/)	让AI代理自动选择最佳后端（API、MCP、CLI、SDK）	通过 npx skills add … 安装

典型工作流

1. 从网页门户获取单个API密钥并安全存储（HITHINK_FINANCE_API_KEY）。
2. 选择最方便的入口点（技能 → 代理，CLI用于临时查询，SDK用于笔记本，REST用于服务）。
3. 将代码解析为唯一的 thscode（例如 600519.SH）。
4. 调用所需端点（快照、K线、财务数据等）。
5. 对于大结果，系统将文件本地写入（DuckDB或CSV），仅返回路径/摘要给调用者。

适合谁使用

• AI代理（如Claude、Cursor等）：需要实时市场数据的场景——安装技能，使代理能自动在API、MCP或CLI间切换。
• 量化研究人员：构建回测、因子模型或仪表板——使用CLI或marketdb保持本地DuckDB副本，并用SQL查询。
• 开发者：构建交易导向的Web或移动应用——直接调用REST API，支持任意语言。
• 数据工程师：需要批量市场数据用于数据湖摄入。

安全与合规说明

• API密钥绝不能硬编码或提交到源代码管理。
• 大型结果集必须写入磁盘；服务不会流式传输大型JSON负载，以避免上下文溢出。
• 本服务不提供投资建议——调用者必须将任何分析标记为“非建议”。
• 限速为软限制（无硬性配额），但建议避免突发性高并发流量。

项目状态

• 活跃维护的单体仓库（Python + Node.js CLI + 技能）。
• 最近版本增加了集合竞价数据、扩展了基金覆盖范围，并引入了统一技能。
• 未来路线图提及将与即将推出的同花顺AI客户端集成，以实现更紧密的LLM工作流。

许可证 – MIT。

---

以上所有信息均直接来自仓库的README；未推断任何额外功能。