跳到主要内容

基金总览

基金模块提供基金资料、持仓、业绩、持有人、经理、公司、财务、诊断、募集、资讯与行情数据查询。 基金业务接口使用 thscode 唯一定位基金;经理、公司接口分别使用 manager_idcompany_id,行情接口当前仅支持 ETF。thscode 必须保留市场后缀。

功能分类

分类路径前缀说明
基金基本资料/api/fund/profile查询基金名称、成立日期、管理人与基金经理等基本资料。
基金重仓持仓/api/fund/portfolio/holdings查询基金定期披露的股票、债券和基金持仓。
基金持仓与资产配置/api/fund/portfolio查询历史股票/债券持仓、报告期、资产与行业配置。
基金业绩与回撤/api/fund/performance查询基金净值、收益、净值波动、趋势强弱、估值百分位与最大回撤。
基金持有人数据/api/fund/holders查询持有人结构与前十大持有人。
基金分红记录/api/fund/corporate-actions查询基金历史分红。
基金经理数据/api/fund/managers查询经理投资风格、业绩、经历与详情。
基金公司详情/api/fund/companies查询基金公司基本信息、基金数量与规模。
基金诊断详情/api/fund/diagnostics查询诊断维度、同类对比与韧性指标。
基金募集列表/api/fund/offerings查询当前募集或即将募集的新发基金。
基金资讯列表/api/fund/news游标分页查询基金资讯文章。
基金财务数据/api/fund/financials查询财务指标、利润表与资产负债表。
基金行情数据/api/fund/market查询场内基金行情快照与场内基金前复权历史日线行情。

通用约定

  • Base URLhttps://fuyao.aicubes.cn
  • 必需请求头X-api-key,缺失、无效或无权访问时返回认证/权限错误码。
  • thscode:基金唯一标识,必须使用包含市场后缀的完整同花顺代码,例如 025480.OF510300.SH161725.SZ
  • 时间戳均为毫秒级 Unix 时间戳;有可信上游数据时间时 data.timestamp 保留该时间,否则使用服务端响应组装时间。收益率、占比与涨跌幅均为百分数原值,例如 8.88 表示 8.88%

错误与约束

code含义基金场景
1001缺少必填参数缺少 thscodestartend 等必填参数。
1002参数格式错误历史行情 thscode 含逗号。
1003参数值越界枚举非法、start > end 或查询窗口超过 5 年。
3001标的不存在找不到该基金。
3002数据未就绪标的存在,但暂无可用业务数据。
3004标的类型不支持该能力该基金类型不支持所请求的能力。