同花顺金融数据
同花顺官方 A 股金融数据服务,提供实时与历史行情、财务报表、指数、板块、涨停等数据,面向 AI Agent、量化研究与应用开发,支持 REST API、MCP、CLI 和 Python SDK 接入。
访问 Hithink-Tech-Org/Financial-API项目简介
同花顺金融数据是由同花顺官方提供和维护的 A 股金融数据服务,面向 AI Agent、量化研究者和应用开发者。通过统一 API Key,可查询 A 股行情、财务报表、指数与板块、公募基金、公开期货期权、资讯及特色数据,并可通过 REST API、MCP、CLI、Python SDK、本地 DuckDB 或 Agent Skill 接入现有工作流。
核心功能
- 提供 A 股实时行情、历史 K 线、集合竞价、财务报表、估值快照与交易日历等数据查询能力。
- 覆盖指数与板块、公募基金、公开期货与公开期权、资讯及涨跌停、龙虎榜等特色数据。
- 支持 REST API、MCP、CLI、Python SDK 和 Agent Skill 等多种接入方式。
- CLI 可整合远端取数、本地 DuckDB、认证和结构化输出,并支持批量导出。
- 提供按 A 股、指数、基金、期货、期权、港股新股等数据域配置的 MCP 服务。
- 支持本地 DuckDB 初始化、同步、校验、修复、SQL 查询和导出。
适用场景
- 让 AI Agent 自动查询和分析金融数据。
- 在量化研究与回测中准备历史行情和财务数据。
- 让网站、App 或后台服务通过 REST API 集成金融数据。
- 在终端或自动化任务中统一取数、批量导出并维护本地数据库。
快速开始
- 获取 API Key,或在 CLI 中使用 OAuth 登录。
- 安装 CLI:运行 npm install -g @hithink-tech/hithink-finance-cli,然后执行 hithink-finance auth login 和 hithink-finance capabilities --format json。
- 调用 REST 接口时,在请求头中携带 X-api-key。
- 在支持 MCP 的客户端中按数据域配置 MCP 服务地址,并在请求头中加入 X-api-key。
- 安装 Python 子项目可使用 python -m pip install -e ./python,并可运行 Python toolkit 脚本查询数据。
部署与要求
- Python SDK 需要 Python 3.11+。
- CLI 需要 Node.js 22.12+。
- REST、MCP、Python 及 CLI 的 API Key 方式需要在 API Key 管理页获取 Key。
- MCP 客户端需支持 MCP,并按服务配置结构设置 type、url 和 X-api-key 请求头。
采用前须知
- 许可证:MIT。在使用、修改或分发项目前,请确认其具体条款。
- 公开接入方式有明确的数据边界,不提供分钟 K、tick、Level-2、港股或美股行情、宏观数据、新闻公告原文、研报原文、基金申赎交易和投资推荐。
- 数据权限和实际可访问能力受官网与账号授权约束,未支持的数据不能用模拟或静态示例冒充真实结果。
- API Key 不应写入代码、文档、Issue、日志、产物或 Git,本地持久化应使用用户级安全存储方式。
- 项目不设置累计调用次数上限,但调用方需避免短时间集中请求或过高并发,触发动态限流后应降低频率和并发度并延迟重试。
- 离线文档、测试和帮助信息只能证明支持范围,线上可用性需要通过实际授权请求验证。