同花顺金融数据服务

📌 核心价值：一个 API Key，把 A 股行情、财务、指数、板块、基金、期货期权统一成 AI Agent 能直接调用的数据层。

同花顺官方开源的金融数据接入层，用 REST、MCP、CLI、Python SDK 和本地 DuckDB 五种方式把分散的数据源收口，让量化研究和智能体开发省去到处对接的麻烦。

⚠️ 风险提示：本文仅作技术交流，不构成投资建议。市场有风险，决策需谨慎。

---

🚀 什么是同花顺金融数据服务？

做量化研究或搭 AI 投研智能体，最累的往往不是策略，而是把数据先凑齐：行情要去一个接口、财务要去另一个、指数板块又是一套。同花顺把这套能力做成了官方统一数据服务（hithink-finance），对外以 MIT 协议开源仓库 HiThink-Tech/Financial-API 提供接入规范与工具链。

它面向三类人：AI Agent 开发者（让智能体自动取数分析）、量化研究者（回测、因子、面板研究）、应用开发者（网站、App、后台服务集成）。

核心定位：它不是某个单一数据源，而是一层"统一数据接入总线"——一份 API Key，六种标准入口。

---

✨ 数据能力一览

覆盖从标的信息、行情、财务到特色数据的完整链路，下面是能力清单（均为官方公开数据范围）：

几个值得关注的点：

• 历史 K 线与复权：支持前复权/后复权日线，直接对接回测与趋势研究，不用自己拼除权除息。
• 财务报表与指标：利润表、资产负债表、现金流量表加财务指标一次性取回，做财务健康分析很顺手。
• 指数与板块：成分股目录、快照、历史行情都在同一入口，做板块轮动研究不用换接口。
• 连板梯队与异动监控、龙虎榜：这些特色数据对短线结构研究很有用，官方以标准化字段输出，避免自己爬取。
• 公募基金 / 公开期货期权：基金资料、经理、净值、持仓、场内行情，以及期货期权品种、合约、分时、日 K 都能取。

边界要讲清楚：公开方式不提供分钟 K、tick、Level-2、港股美股行情、宏观与新闻研报原文；标记为端内专用的能力走同花顺 AI 客户端。请求未支持的数据时，接口会如实返回，不会用模拟数据冒充。**

---

🛠️ 五种接入方式，按需取用

• Agent Skill（推荐给智能体）：统一入口，根据任务自动在 CLI / MCP / REST 之间选最合适的调用方式，还能做标的消歧。
• CLI（推荐给终端与自动化）：整合远端取数、本地 DuckDB、认证和结构化输出，一条命令导出。
• MCP（推荐给 ChatBot / IDE）：提供六个托管服务，配好 API Key 即可在对话里直接问数据。
• REST API：标准 HTTP 接口，适合网站、App、后台自定义集成。
• Python SDK：适合 Notebook 和研究流程，支持自定义分页。
• 本地 DuckDB（marketdb）：把全市场日线增量同步到本地库，用 SQL 长期研究。

---

💡 快速上手：几条命令跑通

1. 装 Agent Skill（让 AI 自动取数）

npx skills add HiThink-Tech/Financial-API --skill hithink-finance -g --yes

装好后在新会话直接描述需求即可：

查询贵州茅台的最新行情，并分析近一年的区间表现、最大回撤和均线趋势。

2. CLI 取数

npm install -g @hithink-tech/hithink-finance-cli
hithink-finance auth login
hithink-finance capabilities --format json

# 按代码查找标的
hithink-finance symbol search --q 600519 --limit 5 --format json

# 最新行情
hithink-finance market snapshot --thscodes 600519.SH --format json

# 最近四期利润表
hithink-finance financials income --thscode 600519.SH --limit 4 --format json

3. REST API 直接调

curl 'https://fuyao.aicubes.cn/api/a-share/prices/snapshot?thscodes=600519.SH' \
  -H 'X-api-key: <API_KEY>'

4. MCP 接入（以 A 股服务为例）

{
  "mcpServers": {
    "hithink-finance-a-share": {
      "type": "http",
      "url": "https://fuyao.aicubes.cn/mcp/a-share",
      "headers": { "X-api-key": "${HITHINK_FINANCE_API_KEY}" }
    }
  }
}

安全提示：API Key 不要写进代码、README、Issue、日志或产物；本地优先用用户级环境变量或凭据库。

---

📊 真实效果演示（均为官方示例输出）

下面这些图表都来自仓库 examples/inspirations/ 的真实预览图，展示数据组合后的样子。

单股行情与趋势速览

把最新行情、近一年日 K、均线、区间表现和最大回撤组合成一张图。

财务健康分析

三张报表与财务指标拉通，做横向对比。

指数成分股

查指数目录、成分股快照与历史行情。

连板梯队与异动监控

把连板梯队、异动、热榜、龙虎榜等特色数据做成可视图。

自选股异动

监控自选标的价格与成交异动。

本地 DuckDB 研究

把全市场日线同步到本地库后用 SQL 研究。

行业强弱轮动

板块强弱与轮动结构一目了然。

量价突破

价格与成交量的突破形态识别。

龙虎榜资金流

龙虎榜席位资金流向可视化。

---

🧩 技术架构一条线

整条链路可以概括为：统一 API Key → 网关路由到六个业务域（A 股 / 指数板块 / 元数据 / 基金 / 期货 / 期权）→ 按接入方式输出（REST / MCP / CLI / Python / DuckDB）。

• 远端取数走统一鉴权，结果可结构化输出（JSON）或直接落盘大文件；
• Agent Skill 在本地做"方式选择 + 标的消歧 + 契约校验"，把前端页面组织的 REST 契约和按业务域合并的 MCP 工具文档镜像到本地；
• 大结果走 CLI / Market Dumps 落盘，长周期历史行情用 marketdb 在本地 DuckDB 维护，SQL 即可研究。

工程亮点：契约即文档。 仓库内 docs/api/ 与 Skill 的 REST 文档按单接口页 + 多接口模块页组织，契约更新后一条命令同步，避免文档与接口漂移。**

---

👥 适用人群

• ✅ AI Agent 开发者：用 MCP 或 Skill 让智能体一句话取数、自动分析。
• ✅ 量化研究者：历史 K 线、财务、估值、板块数据一把取齐，回测和因子研究省心。
• ✅ 应用开发者：REST API 标准 HTTP，接入网站、App、后台零依赖。
• ✅ 数据分析师：本地 DuckDB + SQL，长期维护全市场日线做面板研究。
• ❌ 不适合：需要分钟 K / tick / Level-2、港股美股行情或新闻研报原文的用户（当前公开方式不提供）。

---

📝 小结

同花顺金融数据服务把分散的 A 股数据收口成一个官方、统一、多协议的接入层：一份 Key，REST / MCP / CLI / Python / DuckDB 五种入口随用随取。对做 AI 投研智能体和量化研究的人来说，最大的价值不是"多了一个数据源"，而是省掉了对接、鉴权、复权、落盘这些脏活，把精力留给真正的研究。

技术栈：TypeScript CLI + Python SDK + DuckDB + 六个 MCP 托管服务；协议 MIT；在线文档与 llms-full.txt 全文可检索。数据权限以官网账号授权为准。