项目介绍
本服务是面向 AI Agent、量化研究与 Fintech 应用 的结构化金融数据服务。 我们将 A 股市场的行情、除复权、财务报表、交易日历、指数行情、同花顺指数、涨跌停数据与跨市场标的元信息整理为低延迟、易解析的结构化字段， 通过统一的响应信封对外暴露，方便接入方直接喂模型、做回测或驱动前端图表。当前目录采用 基础数据 + A股 双主干：基础数据负责标的检索与标的列表获取，A股主干聚合已上线的行情、财务、指数与特色功能数据。
提供的数据
| 数据域 | 内容 | 说明 |
|---|---|---|
| 元信息 · 标的检索 | 跨市场标的消歧检索 | 按 thscode / ticker / 名称解析标准标的。 |
| 元信息 · 标的列表获取 | 代码表批量获取 | 按市场与资产类型分页获取标的列表。 |
| A 股 · 交易日历 | 近一年交易日序列 | 同时返回 date_ms 毫秒戳与 date（yyyyMMdd）。 |
| A 股 · 行情数据 | 单只 / 多只 / 全市场行情快照 + 历史 K 线（日 / 周 / 月） | 支持前复权 / 后复权。 |
| A 股 · 市场数据导出 | 全 A 股 10 年日 K、最近 10 交易日日 K 与全历史复权因子 Parquet 文件 | 通过预签名链接一次性拉全市场数据。 |
| A 股 · 除复权 | 现金分红、送股、配股原始事件流 | 客户端可自行推导复权因子。 |
| A 股 · 财务报表 | 利润表 / 资产负债表 / 现金流量表多期 序列 | 支持最近 N 期或时间区间取数。 |
| A 股 · 指数行情与同花顺指数 | 指数行情快照 / 历史 K 线、同花顺指数列表与成分股 | 同时支持沪深 300 等标准指数的成分股查询。 |
| A 股 · 涨跌停数据 | 涨停股票池与连板天梯 | 面向盘面复盘和短线情绪分析。 |
字段统一使用 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 并预览结果。