API REFERENCE

基金持仓

查询定期报告披露的股票持仓,不是实时持仓。

数据范围
公募基金定期报告披露的股票持仓
包含内容
持仓股票代码、数量、市值、占比、报告期及公告日期;不表示实时或全部持仓
时间覆盖
已核实 000001.OF 的 2002-03-31 及 2026-06-30 报告期记录;各基金按已披露报告期提供,公告日晚于报告期末,不是每日或全量持仓
数据频率
季度等定期披露

基金持仓

POSThttps://jinniu.lingxideai.com/api/fund_portfolio

查询定期报告披露的股票持仓;季度披露不代表每日或全部实时持仓。end_date 为报告期,ann_date 为公告日;回测应以公告后可见时间使用。

共用“ETF、基金、LOF历史”权限及期限,一次开通即可使用 ETF、LOF 历史和本组公募基金接口;不包含实时权限。覆盖起始日期随基金与数据项不同,以实际可用记录为准,不承诺所有基金全历史完整覆盖。

ts_code、ann_date、period 至少填一个。

参数必填说明
api_key是账户 API Key,也可通过 X-Api-Key 请求头传入。
ts_code条件见上文基金代码,如 001753.OF、159995.SZ;基金经理支持逗号分隔的多个代码(最多100个),其余接口限单个。
ann_date条件见上文公告日期,YYYYMMDD 或 YYYY-MM-DD。
period条件见上文报告期末日期,季度末 YYYYMMDD,例如 20260630。
symbol条件见上文持仓股票代码,如 600000.SH。
start_date条件见上文起始日期;净值为净值日期,持仓为报告期末日期。
end_date条件见上文截止日期;净值为净值日期,持仓为报告期末日期。
limit否1 至 2000,默认 2000;全站设置与本接口上限取较小值。
offset否偏移行数,默认0,最大10000000;保持筛选条件不变,按 next_offset 继续。可能有下一页不代表一定还有记录。
fields否逗号分隔的返回字段;不填返回默认字段。可选:ts_code,ann_date,end_date,symbol,mkv,amount,stk_mkv_ratio,stk_float_ratio。

调用示例

curl -X POST 'https://jinniu.lingxideai.com/api/fund_portfolio' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"limit": 2, "period": "20260630", "ts_code": "001753.OF"}'

返回字段

字段说明
ts_code基金代码;无单位。
ann_date公告日期,YYYYMMDD。
end_date经理为离任日期;持仓为报告期末;管理人为终止日期。
symbol持仓股票代码。
mkv持仓市值,单位:元人民币。
amount持仓数量,单位:股。
stk_mkv_ratio占股票市值比,单位:%。
stk_float_ratio占流通股本比,单位:%。
data.meta.returned_count / limit / max_rows / offset / next_offset本页数量、分页大小、有效上限、当前偏移、下一页偏移;单位:条。末页 next_offset 为 null。
data.meta.possibly_more本页是否已满。缺失数值保留 null,不补零。

返回结构示例

{"data": {"fields": ["ts_code", "ann_date", "end_date", "symbol", "mkv", "amount", "stk_mkv_ratio", "stk_float_ratio"], "items": [], "meta": {"limit": 2, "next_offset": null, "offset": 0, "possibly_more": false, "returned_count": 0}}, "message": "", "success": true}

SDK:client.fund_portfolio(...);MCP 工具:fund_portfolio。参数错误返回 HTTP 400 和英文原因;服务暂不可用返回 HTTP 503,不伪装为空数据。调用频率、并发及错误处理统一见调用规则。