查询定期报告披露的股票持仓,不是实时持仓。
- 数据范围
- 公募基金定期报告披露的股票持仓
- 包含内容
- 持仓股票代码、数量、市值、占比、报告期及公告日期;不表示实时或全部持仓
- 时间覆盖
- 已核实 000001.OF 的 2002-03-31 及 2026-06-30 报告期记录;各基金按已披露报告期提供,公告日晚于报告期末,不是每日或全量持仓
- 数据频率
- 季度等定期披露
基金持仓
POST
https://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,不伪装为空数据。调用频率、并发及错误处理统一见调用规则。