接口总览

同花顺金融数据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/news/events/search`	按标题、正文、时间、评级与关联板块检索资讯事件，仅在同花顺AI客户端内提供。
资讯详情	`/api/news/article/detail`	资讯域公开查询能力，字段及限制见接口说明。
快讯列表	`/api/news/flash/list`	资讯域公开查询能力，字段及限制见接口说明。
公告详情与解读	`/api/news/notice/detail`	资讯域公开查询能力，字段及限制见接口说明。
热门深度专题	`/api/news/topic/hot-list`	资讯域公开查询能力，字段及限制见接口说明。
日期范围异动解读	`/api/news/anomaly/analysis`	资讯域公开查询能力，字段及限制见接口说明。
个股分时新闻	`/api/news/stock/timeline-list`	资讯域公开查询能力，字段及限制见接口说明。
标的检索	`/api/meta/tickers/search`	按 thscode / ticker / 名称检索证券、基金、期货与期权标的。
标的列表获取	`/api/meta/tickers/list`	按规范化资产类型分页获取代码表。
基金	`/api/fund`	基金资料、持仓、业绩、经理、财务、诊断、募集、资讯与行情数据。
基金在线回测	`/api/fund/backtest`	执行基金在线回测并查询可用指标。
QDII 额度	`/api/fund/quota`	查询 QDII 分类额度汇总与基金列表。
期货总览	`/api/futures`	期货品种、合约、持仓、仓单、基差、基本面、交易日与行情。
期货F10基本面指标历史数据	`/api/futures/fundamentals`	期货 F10 基本面指标历史数据，计划在后续版本接入同花顺AI客户端，敬请期待。
期货交易时间轴	`/api/futures/calendar/session-timeline`	期货合约最近交易日的交易时间轴。
期权总览	`/api/options`	期权品种、合约、分时行情、K 线与交易时间轴。
期权交易时间轴	`/api/options/calendar/session-timeline`	期权合约最近交易日的交易时间轴。
除复权 (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 等标准指数）。
涨停市场统计	`/api/a-share/special-data/limit-up-statistics`	查询封板率、涨停打开家数、页面板数档位及精确连板家数。
个股机构交易详情	`/api/a-share/special-data/dragon-tiger-stock-institution`	按股票和交易日查询机构买入、卖出、净买入金额，以及机构数量、比例和营业部身份。
营业部数据	`/api/a-share/special-data/dragon-tiger-department-classic-record`	查询营业部身份及一条代表战绩。
异动监控	`/api/a-share/special-data/abnormal-monitor-list`	查询当前或历史异动监控记录。
集合竞价机会	`/api/a-share/special-data/auction-stock-opportunities`	筛选实时或历史集合竞价机会，一个股票可包含多条机会记录。
A股打新日历	`/api/a-share/ipo/calendar-list`	按沪深或京市及待申购、可申购、待上市阶段查询股票发行记录。
港股打新	`/api/hk-share/ipo/application-list`	分页查询港股公司递表记录，保留同一公司的重复申请。
市场成交额预测	`/api/a-share/special-data/turnover-prediction-snapshot`	同花顺AI客户端内的数据契约。
宽基ETF申购净流入	`/api/fund/etf-flow/net-inflow-historical`	同花顺AI客户端内的数据契约。
同花顺筹码形态	`/api/a-share/special-data/chip-shape-dates`	同花顺AI客户端内的数据契约。
同花顺新增概念	`/api/a-share-index/baseinfo/new-concepts`	同花顺AI客户端内的数据契约。
同花顺热榜	`/api/a-share/special-data`	飙升热股、热股排行、历史热股排行与个股排名走势。

通用约定

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 均表示触发限流。此时请降低并发量和请求频率，避免立即连续重试，并在稍后重新发起请求。

原生批量查询

历史行情和 A 股三类报表的批量接口使用必填的英文逗号分隔 thscodes，每次最多 10 个原始代码项；规范化后稳定去重，按首次出现顺序返回有效标的组。代码数量与各接口时间窗口分别限制。

数据	单次代码上限	入口
A 股历史 K 线	10	批量历史 K 线
指数历史 K 线	10	指数批量历史 K 线
ETF 历史日线	10	场内基金批量历史日线行情
A 股利润表、资产负债表、现金流量表	每类 10	批量财务报表

历史批量数据为 {interval,adjust,item:[{thscode,timestamp,item:[]}]}；财报批量数据为 {item:[{thscode,timestamp,item:[]}]}。每组记录沿用对应单标的字段与排序，有效标的无数据时保留 timestamp:null,item:[]。未知或不匹配的标的省略；仍有有效目标时外层返回 code=0。单唯一目标类型不支持返回 3004，其它零有效目标返回 3001；整体错误返回非零信封和 data:null。

ETF/LOF 快照通过原基金快照接口的 thscode 参数支持最多 100 个原始代码项，返回平铺行情记录。CLI/MCP 的可用入口分别以 capabilities、tools/list 为准。

响应信封

响应记录中的同花顺代码（如 thscode）无法确定时可为 null。

正常进入业务处理的请求返回统一的 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`	参数格式错误	代码格式、空段或日期格式错误。
`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 调用。工具命名、参数与返回值见 MCP 工具概览。

接口分组​

通用约定​

调用频率与限流​

原生批量查询​

响应信封​

错误码​

MCP 接入​