Skip to content
Back to search

financial-api

同花顺官方 A股金融数据服务,提供股票实时行情、历史行情、财务报表、指数、板块、涨停等数据,适用于 AI Agent、量化研究和应用开发,支持 API、MCP、CLI 和 Python。Official Tonghuashun (HiThink) A-share financial data service providing real-time and historical stock market data, financial statements, indices, sectors and limit-up data for AI agents, quantitative research and application development.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Hithink-Tech-Org/Financial-API with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Hithink-Tech-Org/Financial-API'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hithink-tech-financial-api/badge.svg)](/listings/hithink-tech-financial-api)

HTML

<a href="/listings/hithink-tech-financial-api"><img src="/api/listings/hithink-tech-financial-api/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 290 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # 同花顺金融数据服务
  2. [![Website](https://img.shields.io/badge/官网-fuyao.aicubes.cn-0b66ff)](https://fuyao.aicubes.cn/)
  3. [![Docs](https://img.shields.io/badge/API%20Docs-同花顺金融数据服务-0f766e)](https://fuyao.aicubes.cn/docs/)
  4. [![Python](https://img.shields.io/badge/Python-3.11%2B-3776ab)](python/pyproject.toml)
  5. [![Node.js](https://img.shields.io/badge/Node.js-22.12%2B-339933)](hithink-finance-cli/package.json)
  6. **同花顺金融数据服务(hithink-finance)** 是由同花顺官方提供和维护的 A 股金融数据服务,面向 AI Agent、量化研究者和应用开发者。
  7. 通过统一 API Key,可以查询 A 股行情、集合竞价、财务报表、估值、指数与板块、公募基金、公开期货期权、特色数据及 A 股和港股新股资料,并通过 REST API、MCP、CLI、Python SDK、本地 DuckDB 或 Agent Skill 接入现有工作流。
  8. > 一站式同花顺官方金融数据能力,覆盖查询、研究、批量导出和 AI Agent 自动调用。
  9. - 官网:<https://fuyao.aicubes.cn/>
  10. - 在线文档:<https://fuyao.aicubes.cn/docs/>
  11. - API Key 管理:<https://fuyao.aicubes.cn/admin/>
  12. - 仓库文档中心:[`docs/`](docs/README.md)
  13. - 同花顺AI客户端:[下载并体验](https://lumi.10jqka.com.cn/?channel=Hithink-API)
  14. > API、MCP、CLI、Python SDK 和 Agent Skill 适合自主接入;同花顺AI客户端已接入当前数据源,金融数据与分析能力已内置,打开客户端即可使用。
  15. ## 选择接入方式
  16. | 使用场景 | 推荐方式 | 说明 |
  17. | --- | --- | --- |
  18. | 让 AI Agent 自动查询和分析金融数据 | [CLI 内置 Skills](hithink-finance-cli/README.md#agent-skill-lifecycle) | 根据各内置 Skill 的 description 直接选择业务域 |
  19. | 在终端、Agent 或自动化任务中统一取数和导出 | [CLI](hithink-finance-cli/README.md) | 整合远端取数、本地 DuckDB、认证和结构化输出 |
  20. | 在 Chat Bot 或 IDE 中直接调用 | [MCP](docs/mcp.md) | 配置托管服务和 API Key 后在对话中使用 |
  21. | 接入网站、App、后台服务或其他语言 | [REST API](docs/api/README.md) | 标准 HTTP 接口,适合自定义集成 |
  22. | 在 Python、Notebook 或研究流程中使用 | [Python SDK](python/README.md) | 适合数据处理、自定义分页和研究脚本 |
  23. | 长期维护历史行情并使用 SQL 研究 | [marketdb](python/toolkit/marketdb/README.md) | 本地构建和增量维护 DuckDB 数据库 |
  24. | 获取全市场或长时间范围数据 | [CLI](hithink-finance-cli/README.md) / [Market Dumps](docs/api/market-dumps.md) | 使用批量能力并让大结果直接落盘 |
  25. | 免配置使用金融数据或端内专用能力 | [同花顺AI客户端](https://lumi.10jqka.com.cn/?channel=Hithink-API) | 数据源已经接入,打开客户端即可使用 |
  26. Agent 和终端任务优先使用 CLI 及其内置 Skills;REST 文档与 HTTP 接口选路使用 `hithink-finance`,MCP 配置及工具调用使用 `hithink-finance-mcp`。
  27. ## 数据能力与边界
  28. | 数据 / 能力 | 主要用途 | 推荐入口 |
  29. | --- | --- | --- |
  30. | 标的目录 | 根据名称、代码或关键词查找唯一 `thscode` | CLI / API / MCP / Python |
  31. | A 股最新行情 | 查询单只、多只或全市场股票的最新价格与交易数据 | CLI / API / MCP / Python |
  32. | A 股历史 K 线 | 获取历史走势,用于研究、回测和趋势分析 | CLI / marketdb |
  33. | 集合竞价 | 查询竞价实时或终态快照与短期强弱基准 | CLI / API / MCP / Python |
  34. | 公司行动与复权 | 查询分红、送转等公司行动并生成复权数据 | CLI / marketdb |
  35. | 财务报表与指标 | 查询利润表、资产负债表、现金流量表和财务指标 | CLI / API / MCP / Python |
  36. | A 股估值快照 | 批量查询市盈率、市净率、市销率和市现率 | CLI / API / MCP / Python |
  37. | 交易日历 | 判断交易日并安排数据同步或研究窗口 | CLI / API / MCP / Python |
  38. | 指数与板块 | 查询目录、成分股、快照和历史行情 | CLI / API / MCP / Python |
  39. | 特色数据 | 查询涨跌停、炸板、连板、异动、热榜和龙虎榜 | CLI / API / MCP / Python |
  40. | 公募基金 | 查询资料、公司、经理、财务、持仓、净值、业绩、资讯和场内行情 | CLI / API / MCP / Python |
  41. | 公开期货 | 查询品种、合约、持仓、仓单、基差、交易日程、分时和日 K | CLI / API / MCP / Python |
  42. | 公开期权 | 查询品种、合约、分时和日 K | CLI / API / MCP / Python |
  43. | 资讯 | 查询资讯详情、快讯、公告解读、专题、日期范围异动解读与个股分时新闻 | CLI / API / MCP / Python |
  44. | 全市场数据文件 | 下载全量或增量日 K、公司行动等标准数据文件 | CLI / Market Dumps |
  45. | 本地 DuckDB | 初始化、同步、校验、修复、SQL 查询和导出 | CLI / marketdb |
  46. | 端内专用数据与分析 | 在客户端使用资金流向、高频动向和期货期权专业数据 | [同花顺AI客户端](https://lumi.10jqka.com.cn/?channel=Hithink-API) |
  47. 当前公开方式不提供分钟 K、tick、Level-2、港股或美股行情、宏观数据、新闻公告原文、研报原文、基金申赎交易和投资推荐。标记为“端内专用”的能力已内置于同花顺AI客户端,不通过公开 API、MCP、CLI 或 Python SDK 提供。数据权限及实际可访问能力以官网和账号授权为准;请求未支持的数据时,不使用模拟数据或静态示例冒充真实结果。
  48. ## 快速开始
  49. ### 1. 选择认证方式
  50. CLI 默认推荐 OAuth:先运行 `hithink-finance auth status --format json` 复用当前有效凭据;首次登录使用 `hithink-finance auth login --method oauth`,按提示完成浏览器授权。
  51. REST、MCP、Python 及 CLI 的 API Key 方式共用在 [API Key 管理](https://fuyao.aicubes.cn/admin/) 获取的 Key。选择此方式后,Agent 可完成 Key 签发、安全交接、用户级持久配置和真实请求验证。具体流程见 [API Key 创建与持久配置](skills/hithink-finance/references/api-key-onboarding.md)。
  52. 用户可以直接把 API Key 提供给 Agent 上下文以便代配;Agent 不应复述,并应提示聊天平台可能保留消息记录。Key 不要写入代码、README、Issue、日志、产物或 Git;本地持久化优先使用用户级环境变量、用户级凭据文件、系统凭据库或客户端 Secret。
  53. ### 2. Agent Skill
  54. 按实际接入方式使用独立 Skill:
  55. | Skill | 职责 |
  56. | --- | --- |
  57. | [`hithink-finance`](skills/hithink-finance/SKILL.md) | REST API Wiki 与 API Router:接口文档、HTTP 接口选择、参数和返回字段契约,附带 CLI 简介、安装准备与首次接入 |
  58. | [`hithink-finance-mcp`](skills/hithink-finance-mcp/SKILL.md) | MCP 配置与连接、业务域和 tool 选路、单工具参数与返回要求 |
  59. 各自安装或分发时保留完整目录及 `references/`。MCP 契约按业务分类组织,每个工具保留包含参数、返回字段和关联结构的独立小节,可以独立使用。
  60. CLI 配套领域 Skills 随 npm 包安装,并由 CLI 发布到用户级共享目录,再链接到已安装 Agent:
  61. ```bash
  62. npm install -g @hithink-tech/hithink-finance-cli
  63. hithink-finance skills status --format json
  64. ```
  65. CLI 的业务请求由宿主按内置 Skill 的 description 直接选择领域。CLI 配套 Skills 的同步规则见 [CLI 文档](hithink-finance-cli/README.md#agent-skill-lifecycle)。
  66. 重新打开 Agent 会话后即可直接描述需求:
  67. ```text
  68. 查询贵州茅台的最新行情,并分析近一年的涨跌幅、最大回撤和均线趋势。
  69. ```
  70. ### 3. CLI
  71. CLI 是人类终端、Agent 和自动化任务的默认推荐入口:
  72. ```bash
  73. npm install -g @hithink-tech/hithink-finance-cli
  74. hithink-finance auth login
  75. hithink-finance capabilities --format json
  76. ```
  77. 常见命令:
  78. ```bash
  79. # 根据代码或名称查找股票
  80. hithink-finance symbol search --q 600519 --limit 5 --format json
  81. # 查询最新行情
  82. hithink-finance market snapshot --thscodes 600519.SH --format json
  83. # 查询最近四期利润表
  84. hithink-finance financials income --thscode 600519.SH --limit 4 --format json
  85. # 初始化本地数据库
  86. hithink-finance data init --format json
  87. # 查询本地前复权日线
  88. hithink-finance db query \
  89. --sql "SELECT * FROM v_daily_qfq LIMIT 10" \
  90. --format json
  91. ```
  92. CLI 会为已检测到的 Agent 同步配套领域 Skills。支持目标、自定义目录、修复、移除和手工兜底安装方式见 [CLI Skills 管理说明](hithink-finance-cli/README.md#agent-skill-lifecycle)。
  93. 仅在参与仓库开发或 npm 暂不可用时从源码验证:
  94. ```bash
  95. cd hithink-finance-cli
  96. npm ci --ignore-scripts
  97. npm run build
  98. node dist/cli/main.js capabilities --format json
  99. ```
  100. 完整命令和生命周期说明见 [`hithink-finance-cli/README.md`](hithink-finance-cli/README.md)。
  101. ### 4. REST API
  102. REST API 适合服务端、自定义语言和零依赖 HTTP 集成。以下示例查询贵州茅台最新行情:
  103. ```bash
  104. curl 'https://fuyao.aicubes.cn/api/a-share/prices/snapshot?thscodes=600519.SH' \
  105. -H 'X-api-key: <API_KEY>'
  106. ```
  107. - 仓库内契约:[REST API 文档](docs/api/README.md)
  108. - 在线文档:<https://fuyao.aicubes.cn/docs/>
  109. - 文档全文聚合:<https://fuyao.aicubes.cn/llms-full.txt>
  110. `docs/api/` 按业务域提供单接口页与多接口模块页;字段、参数和错误语义以目标接口小节为准。
  111. ### 5. MCP
  112. MCP 适合 Claude Desktop、Cursor、Windsurf 和其他支持 MCP 的客户端。按七个数据域提供接入配置,连接后以实时 `tools/list` 确认可用工具:
  113. | 服务名称 | 地址 | 主要能力 |
  114. | --- | --- | --- |
  115. | `hithink-finance-a-share` | `https://fuyao.aicubes.cn/mcp/a-share` | A 股行情、财务、估值、竞价和特色数据 |
  116. | `hithink-finance-a-share-index` | `https://fuyao.aicubes.cn/mcp/a-share-index` | 指数、板块、成分和行情 |
  117. | `hithink-finance-meta` | `https://fuyao.aicubes.cn/mcp/meta` | 标的检索和能力发现 |
  118. | `hithink-finance-fund` | `https://fuyao.aicubes.cn/mcp/fund` | 公募基金资料、披露、净值、收益和场内行情 |
  119. | `hithink-finance-futures` | `https://fuyao.aicubes.cn/mcp/futures` | 公开期货资料、持仓、基差、日程和行情 |
  120. | `hithink-finance-options` | `https://fuyao.aicubes.cn/mcp/options` | 公开期权品种、合约和行情 |
  121. | `hithink-finance-hk-share` | `https://fuyao.aicubes.cn/mcp/hk-share` | 港股新股递表、认购、上市日历与发行详情 |
  122. 单个服务的配置结构如下:
  123. ```json
  124. {
  125. "mcpServers": {
  126. "hithink-finance-a-share": {
  127. "type": "http",
  128. "url": "https://fuyao.aicubes.cn/mcp/a-share",
  129. "headers": {
  130. "X-api-key": "${HITHINK_FINANCE_API_KEY}"
  131. }
  132. }
  133. }
  134. }
  135. ```
  136. 完整配置、安全方式、服务路由和验证步骤见 [MCP 接入说明](docs/mcp.md)。实际调用或排查参数变化时,以当前连接返回的 `tools/list` 为准。
  137. ### 6. Python SDK 与 marketdb
  138. 安装 Python 子项目:
  139. ```bash
  140. python -m pip install -e ./python
  141. ```
  142. 查询远端数据:
  143. ```bash
  144. python python/toolkit/fuyao/scripts/fuyao.py tickers-search --q "贵州茅台"
  145. python python/toolkit/fuyao/scripts/fuyao.py prices-snapshot --thscodes 600519.SH
  146. ```
  147. 初始化并检查本地数据库:
  148. ```bash
  149. python python/bootstrap.py
  150. marketdb status --json --db data/market.duckdb
  151. marketdb validate --json --db data/market.duckdb
  152. ```
  153. 更多说明:
  154. - [Python README](python/README.md)
  155. - [toolkit 路由](python/toolkit/README.md)
  156. - [marketdb 文档](python/toolkit/marketdb/README.md)
  157. - [Python 可执行示例](python/examples/README.md)
  158. ## 示例与灵感
  159. [`examples/inspirations/`](examples/inspirations/README.md) 提供可以复制使用的 Prompt、预览图和静态 HTML;[`python/examples/`](python/examples/README.md) 提供 SDK、marketdb 和远端数据组合示例。
  160. ### 单股行情与趋势速览
  161. [![单股行情与趋势速览](examples/inspirations/01-stock-overview/preview.jpg)](examples/inspirations/01-stock-overview/README.md)
  162. 该示例组合展示最新行情、近一年日 K、均线、区间表现和最大回撤。
  163. - [完整说明与 Prompt](examples/inspirations/01-stock-overview/README.md)
  164. - [直接打开静态 HTML](examples/inspirations/01-stock-overview/example.html)
  165. > 示例用于说明数据组合方式,不是数据能力契约、投资建议或固定视觉标准。
  166. ## 使用约束
  167. - 本项目不设置累计调用次数上限,但调用方应避免短时间集中请求或使用过高并发;触发动态限流后应降低频率和并发度,并在适当延迟后重试。
  168. - 全市场、分页全集、多标的或长时间窗口结果必须落盘,只在终端或对话中展示路径、行数、窗口和摘要。
  169. - 首次使用名称或不完整代码时,应先检索并确认唯一 `thscode`,不要猜测交易所或指数后缀。
  170. - 历史行情结果应注明时间窗口和复权口径;财务结果应注明报告期。
  171. - 离线文档、测试和帮助信息只能证明支持范围;线上可用性需要通过实际授权请求验证。
  172. - 真实数据不可用时应说明原因,不使用近似数据、静态示例或模拟数据替代。
  173. - 本项目提供金融数据访问和研究数据准备工具,不提供投资建议。
  174. ## 最新变化
  175. - CLI 与 Python toolkit 新增涨停统计、个股机构与营业部记录、严重异动、竞价机会及 A 股和港股新股入口;热榜支持按条数查询。对应 REST/MCP 与 Agent Skill 契约同步更新。
  176. 项目对外可见的重要变化按时间倒序记录在 [`CHANGELOG.md`](CHANGELOG.md),避免在多个入口重复维护易过期的版本摘要。
  177. 旧版根级 Python 用户、脚本和 Agent Prompt 请先阅读 [Monorepo 版本升级指南](docs/monorepo-migration.md);本地数据库和数据文件不需要随代码目录迁移。
  178. ## 项目结构与参与开发
  179. ```text
  180. docs/ 公共文档中心;REST 与 MCP 契约和接入说明
  181. skills/hithink-finance/ 可独立安装的统一 Agent Skill;包含契约镜像
  182. hithink-finance-cli/ Node.js CLI 子项目,运行时不依赖 Python
  183. python/ Python SDK、远端 toolkit、marketdb、示例和测试
  184. examples/ monorepo 级示例导航和静态灵感
  185. scripts/ 仓库级维护脚本
  186. ```
  187. 详细参数和契约下沉到对应子项目 README 或 `docs/`。REST 页面同步到 `hithink-finance`;MCP 工具按业务分类合并到 `hithink-finance-mcp`,每个工具小节包含参数、返回字段和关联结构。契约更新后从仓库根目录运行:
  188. ```bash
  189. python scripts/sync_skill_contracts.py
  190. python scripts/sync_skill_contracts.py --check
  191. python -m pytest python/tests/
  192. cd hithink-finance-cli
  193. npm run verify
  194. ```
  195. `internal/` 和 `sdd-docs/` 属于内部治理与开发记录,不是公开使用入口。
  196. ## 文档导航
  197. - [文档中心](docs/README.md)
  198. - [REST API 契约](docs/api/README.md)
  199. - [MCP 接入说明](docs/mcp.md)
  200. - [CLI README](hithink-finance-cli/README.md)
  201. - [Python README](python/README.md)
  202. - [Python toolkit](python/toolkit/README.md)
  203. - [marketdb 文档](python/toolkit/marketdb/README.md)
  204. - [Agent Skill](skills/hithink-finance/SKILL.md)
  205. - [Monorepo 升级指南](docs/monorepo-migration.md)
  206. - [更新日志](CHANGELOG.md)
  207. ## License
  208. 本仓库采用 [MIT License](LICENSE)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.