接口总览
同花顺金融数据API 通过 REST 接口提供能力，其中已注册的公开能力同时通过 MCP Tools 暴露给 AI Agent 工具链。
公开 REST 与对应 MCP Tool 共享同一套后端 capability，数据语义完全一致；部分数据与分析能力计划在后续版本接入同花顺AI客户端，当前版本暂不可使用本项目数据，敬请期待。
业务响应（含业务错误）通常返回 HTTP 200，
业务结果经响应信封的 code 字段表达；触发限流时也可能返回 HTTP 429。
接口分组
| 分组 | 路径前缀 | 说明 |
|---|---|---|
| 价格数据 (prices) | /api/a-share/prices | A 股行情快照与历史 K 线。 |
| 主力资金 | /api/a-share/capital-flow | A 股主力资金实时快照与历史数据，计划在后续版本接入同花顺AI客户端，敬请期待。 |
| 高频动向 | /api/a-share/high-frequency | A 股个股与指数的高频历史和单日分时数据，计划在后续版本接入同花顺AI客户端，敬请期待。 |
| 全市场数据导出 (market-dumps) | /dump/market-dumps（浏览器）/ /api/dump/market-dumps（API Key） | 价格数据子模块：A 股全市场 10 年日 K、最近 10 交易日日 K 与复权因子 Parquet 文件下载链接。 |
| 标的检索 | /api/meta/tickers/search | 按 thscode / ticker / 名称检索证券、基金、期货与期权标的。 |
| 标的列表获取 | /api/meta/tickers/list | 按规范化资产类型分页获取代码表。 |
| 基金 | /api/fund | 基金资料、持仓、业绩、经理、财务、诊断、募集、资讯与行情数据。 |
| 基金在线回测 | /api/fund/backtest | 执行基金在线回测并查询可用指标。 |
| 基金通用指标 | /api/fund/indicators | 查询基金画线式与表格式指标。 |
| QDII 额度 | /api/fund/quota | 查询 QDII 分类额度汇总与基金列表。 |
| 期货总览 | /api/futures | 期货基础资料、持仓、仓单、基差、交易日程与行情。 |
| 期货合约扩展资料 | /api/futures | 品种板块、主连、主力、次主力与商品指数合约列表，计划在后续版本接入同花顺AI客户端，敬请期待。 |
| 期货F10宏观指标历史数据 | /api/futures/fundamentals | 期货 F10 宏观指标历史数据，计划在后续版本接入同花顺AI客户端，敬请期待。 |
| 期货交易时间轴 | /api/futures/calendar/session-timeline | 期货合约最近交易日的交易时间轴，计划在后续版本接入同花顺AI客户端，敬请期待。 |
| 期权总览 | /api/options | 期权基础资料、分时行情与日 K。 |
| 期权交易时间轴 | /api/options/calendar/session-timeline | 期权合约最近交易日的交易时间轴，计划在后续版本接入同花顺AI客户端，敬请期待。 |
| 除复权 (corporate-actions) | /api/a-share/corporate-actions | A 股复权因子事件流（分红 / 送股 / 配股）。 |
| 财务报表 (financials) | /api/a-share/financials | A 股整体合并利润表 / 资产负债表 / 现金流量表多期序列。 |
| 财务指标数据 | /api/a-share/financials/indicators | A 股成长、盈利、偿债、营运、现金流五类财务指标。 |
| 交易日历 (calendar) | /api/a-share/calendar | A 股近一年交易日序列（含毫秒戳与 yyyyMMdd）。 |
| 集合竞价数据 | /api/a-share/auction | A 股集合竞价快照与短线风向标竞价基准。 |
| 特色数据 (special-data) | /api/a-share/special-data | A 股涨跌停数据、同花顺热榜、个股异动原因与龙虎榜。 |
| 同花顺指数列表和成分股 (a-share-index) | /api/a-share-index | 同花顺指数列表与成分股清单（同时支持沪深 300 等标准指数）。 |
通用约定
- Base URL：
https://fuyao.aicubes.cn。 - 标准
/api/**接口使用请求头X-api-key: <your-api-key>；缺失或无效返回code=2001，无权访问 capability 返回code=2003。Market Dumps 的页面下载按钮使用/dump/**登录 Cookie 入口，API 客户端使用/api/dump/** + X-api-key。 - 股票、指数和基金标的使用完整
thscode（如600519.SH），不接受纯代码ticker（如600519）；基金经理、基金公司详情分别使用manager_id、company_id，具体以端点参数表为准。 - 时间戳字段统一为毫秒级 Unix 时间戳（
long），时区按Asia/Shanghai。
调用频率与限流
本服务当前不限制累计调用次数。为保障服务稳定性，请根据业务场景合理控制请求频率，避免短时间内集中或高并发调用。服务可能依据实时负载动态调整限流策略；HTTP 429 响应或 code=4001 均表示触发限流。此时请降低并发量和请求频率，避免立即连续重试，并在稍后重新发起请求。
响应信封
正常进入业务处理的请求返回统一的 ApiResponse 信封。客户端应同时检查 HTTP 状态码和响应信封中的 code；HTTP 429 表示请求已被限流，无论响应体是否包含标准信封都应按限流场景处理。
{
"code": 0,
"message": "success",
"request_id": "a1b2c3d4e5f6789012345678abcdef01",
"data": {
"timestamp": 1716105600000,
"item": []
}
}
| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 业务结果码，0 表示成功，非 0 表示业务错误。 |
message | string | 结果描述。 |
request_id | string | 请求追踪 ID。 |
data | object | null | 业务数据容器，按接口而定；错误时固定保留，可能为 null。 |
data.timestamp | long | 数据时间戳（毫秒）。 |
data.item | array | 业务数据列表。 |
错误码
| code | 含义 | 典型场景 |
|---|---|---|
0 | 成功 | - |
1001 | 缺少必填参数 | start / end / q / thscode 漏传。 |
1002 | 参数格式错误 | thscode 含逗号，或日期格式错误。 |
1003 | 参数取值越界 | 枚举非法、limit <= 0，或历史查询窗口超过接口上限。 |
1004 | 参数冲突 | financials 同时传 start/end 与 limit；仅传 start 或仅传 end（半开区间）。 |
2001 | 未认证 | X-api-key 缺失或无效。 |
2003 | 权限不足 | API Key 无权调用该 capability。 |
3001 | 标的不存在 | 找不到目标标的。 |
3002 | 数据未就绪 | 标的存在，但暂无可用业务数据。 |
3004 | 标的类型不支持该能力 | 该标的类型不支持所请求的能力。 |
4001 | 频率超限 | 超过约定 QPS。 |
5001 | 服务内部错误 | 服务端未知错误。 |
5002 | 上游服务超时 | 数据源响应超时。 |
5003 | 数据源不可用 | 上游服务暂时不可用、返回失败状态，或响应无法按契约解析和映射。 |
MCP 接入
已注册的公开 REST capability 同时暴露为 MCP Tools，供 AI Agent 调用；计划接入同花顺AI客户端的能力不进入 MCP 工具列表。 工具命名、参数与返回值见 MCP 工具概览。