REST API
为 AI Agent 与量化研究打造的金融数据基础设施
本服务以一套 REST 接口对外提供结构化、低延迟、易解析的 A 股行情、代码表与公司行动数据，方便 LLM Agent、量化平台与 Fintech 应用直接接入。当前阶段聚焦 A 股，所有业务结果通过统一 ApiResponse 信封返回。
你可以访问什么
按 标的宇宙 / 数据类型 两级路径组织，覆盖行情、代码表、公司行动、财务报表、交易日历与全市场导出：
REST API
标准 HTTP 接口，按 /api/<标的宇宙>/<数据类型>/<动作> 形态组织。覆盖行情快照、
历史 K 线、标的检索 / 目录、公司行动与全市场 Parquet 导出。
MCP 工具
面向 AI Agent / LLM 工具链的 MCP Tools，与 REST 共享同一套 capability。 以 MCP Tools 形态暴露，鉴权方式相同。
A 股 · 行情数据
单只 / 多只 / 全市场行情快照 + 单只标的历史 K 线（日 / 周 / 月），支持前复权 / 后复权。
A 股 · 公司行动
单只 A 股的原始复权因子事件流（现金分红 / 送股 / 配股），供客户端自行推导复权因子。
A 股 · 财务报表
单只 A 股的整体合并利润表 / 资产负债表 / 现金流量表多期序列，支持最近 N 期或时间区间取数。
A 股 · 交易日历
A 股近一年交易日序列，同时返回毫秒戳与 yyyyMMdd 可读日期，方便展示与对账。
A 股 · 同花顺指数列表和成分股
按 tag 列出同花顺指数清单，并按 thscode 取当前成分股（同时支持沪深 300 等标准指数）。
元信息 · 标的检索与目录
按 thscode / ticker / 名称做跨市场消歧检索，或按市场与资产类型批量获取代码表。
统一响应信封
所有接口返回 ApiResponse（code / message / request_id / data），业务错误经 code 表达。
面向人群
- AI Agent / LLM 开发者 —— 直接拿结构化字段喂模型，无需自己写抓取与解析层。
- 量化研究 / 策略平台 —— 行情快照 + 历史 K 线 + 复权事件，覆盖回测与实时 打分场景。
- Fintech / 投研产品 —— snake_case 字段直接驱动前端图表与表格。
- 个人开发者 / 学习者 —— 接口契约清晰，API Key 管理页一键签发 API Key 并预览结果。
设计原则
- LLM-friendly schema —— snake_case 字段、显式
currency、毫秒级 Unix 时间戳，减少模型解析歧义。 - 统一响应信封 —— 所有业务结果（含错误）HTTP 200 返回，经
code字段分发，方便客户端单点处理。 - 路径分层清晰 —— URL 形如
/api/<标的宇宙>/<数据类型>/<动作>（如/api/a-share/prices/snapshot）。 - 原始数据为主 —— 复权因子返回原始事件流，客户端可自由推导前复权 / 后复权；预计算结果走
prices?adjust=...。