项目介绍
本服务是面向 AI Agent、量化研究与 Fintech 应用 的结构化金融数据服务。 我们将 A 股市场的行情、公司行动、财务报表、交易日历与代码表整理为低延迟、易解析的结构化字段， 通过统一的响应信封对外暴露，方便接入方直接喂模型、做回测或驱动前端图表。
提供的数据
| 数据域 | 内容 | 说明 |
|---|---|---|
| A 股 · 行情数据 | 单只 / 多只 / 全市场行情快照 + 历史 K 线（日 / 周 / 月） | 支持前复权 / 后复权。 |
| A 股 · 公司行动 | 现金分红、送股、配股原始事件流 | 客户端可自行推导复权因子。 |
| A 股 · 财务报表 | 利润表 / 资产负债表 / 现金流量表多期序列 | 支持最近 N 期或时间区间取数。 |
| A 股 · 交易日历 | 近一年交易日序列 | 同时返回 date_ms 毫秒戳与 date（yyyyMMdd）。 |
| A 股 · 同花顺指数列表和成分股 | 同花顺指数列表 + 成分股清单 | 同时支持沪深 300 等标准指数的成分股查询。 |
| 元信息 · 标的检索与目录 | 跨市场标的检索与代码表批量获取 | 按 thscode / ticker / 名称消歧。 |
| 全市场数据导出 | 全 A 股 10 年日 K 与全历史复权因子 Parquet 文件 | 通过预签名链接一次性拉全市场数据。 |
字段统一使用 snake_case、毫秒级 Unix 时间戳与显式 currency，便于 LLM 解析。
所有业务结果（含错误）走统一 ApiResponse 信封 —— 详见
API 参考 · 通用约定。
接入方式
REST API
标准 HTTP 接口，按 /api/<标的宇宙>/<数据类型>/<动作> 组织。
使用 X-api-key 请求头鉴权。
MCP 工具
面向 AI Agent / 大模型工作流的 Model Context Protocol 接入。 以 MCP Tools 形态暴露同一套 capability，鉴权使用在「API Key 管理」页签发的 API Key。
鉴权方式
调用所有数据接口都需要一个 API Key：
- 使用同花顺账号登录文档站。
- 进入 API Key 管理 页创建一个具名 API Key。
- 在请求头中携带
X-api-key: <your-api-key>即可访问 REST API；MCP 接入同样使用该 API Key。
具体步骤见 快速开始。
面向人群
- AI Agent / LLM 开发者 —— 直接拿结构化字段喂模型，省去抓取与解析层。
- 量化研究 / 策略平台 —— 行情快照 + 历史 K 线 + 复权事件，覆盖回测与实时打分。
- Fintech / 投研产品 —— snake_case 字段直接驱动前端图表与表格。
- 个人开发者 / 学习者 —— 接口契约清晰，「API Key 管理」页一键签发 API Key 并预览结果。