Mutual Fund & ETF Disclosure公募基金与 ETF 披露
该接口按基金或 ETF 代码与报告期查询 SEC N-PORT 监管披露的底层持仓明细,涵盖持仓证券名称、CUSIP、市值、占净值权重及看跌/看涨期权方向,用于基金底层资产穿透分析。
https://quote-fmp.com/stable/funds/disclosure-holders-latest?symbol=AAPL数据更新周期
Daily
接口说明
- 跟踪基金持仓:掌握公募基金与 ETF 最新披露的持仓,包括持股数量及其占投资组合的比例,传入
symbol后可汇总holder(持有人)、securityCusip(证券CUSIP代码)与shares(持股数量) 等要素,可直接嵌入日常投研监控脚本。 - 监控策略变化:通过更新的披露发现基金策略变化,例如投资焦点转移或组合再平衡,基于
securityCusip(证券CUSIP代码)与shares(持股数量) 等核心指标,省去多源报表口径折算与人工核对环节。 - 洞察大型基金:查阅 Vanguard、BlackRock 等大型机构玩家的最新申报,了解其投资决策,工程落库阶段可与「公募基金披露」共用主键索引,形成完整的专题数据集。
- 关联数据线接口:ETF Sector Weighting(ETF 板块权重) · ETF & Fund Holdings(ETF与基金持仓明细) · Institutional Ownership Filings(机构持股申报) · ETF Symbol Search(ETF代码检索)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 底层持仓股票代码,例如 AAPL、MSFT(用于按股票代码反向检索持有该标的的 ETF 或公募基金名单及权重)。 |
调用代码示例
Python 关键代码针对公募基金与 ETF 披露,向 /stable/funds/disclosure-holders-latest 传入必填 symbol后,响应提供 holder(持有人)、securityCusip(证券 CUSIP 代码)、shares(持股数量)(样本 holder=PARNASSUS INCOME FUNDS)。
resp = requests.get(
"https://quote-fmp.com/stable/funds/disclosure-holders-latest",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 dateReported 升序重排并数值化 shares(持股数量)
df["shares"] = pd.to_numeric(df["shares"], errors="coerce")
df = df.sort_values("dateReported").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 获取 AAPL 最新公募基金与 ETF 披露记录 | symbol=AAPL | 通过 symbol=AAPL 访问 /stable/funds/disclosure-holders-latest,一次拿齐 公募基金与 ETF 披露 的 holder、securityCusip、shares 等核心列。 |
| 检索美股 NVDA 公募基金与 ETF 披露截面 | symbol=NVDA | 针对 NVDA 请求 /stable/funds/disclosure-holders-latest,采集对应的 holder、securityCusip、shares 并与 AAPL 面板合并。 |
公募基金与 ETF 披露端点 /stable/funds/disclosure-holders-latest(必填 symbol)单次返回 holder、securityCusip、shares 等 7 项属性;若带日期窗口查询,请确保起止日期为有效交易日。
在本地数据仓库归档公募基金与 ETF 披露时,以 (cik) 去重可防止重跑产生脏数据;其中 shares(持股数量,如 3638451)为原始未缩写数值。
返回数据
7 个字段本接口示例响应共包含 7 个字段(数值型 3 个,文本/日期/布尔型 4 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
cik | string | "0000866256" | SEC CIK 编号(SEC 10 位定长中央索引键,落库须定义为 VARCHAR(10) 字符串以防前导零丢失) |
holder | string | "PARNASSUS INCOME FUNDS" | 持有人 |
securityCusip | string | "037833100" | 证券 CUSIP 代码 |
shares | number | 3638451 | 持股数量 |
dateReported | string | "2026-06-30" | 报告日期 |
change | number | -316881 | 涨跌额 |
weightPercent | number | 4.06607721 | 权重(%) |
查看响应数据示例(原始 JSON)
[
{
"cik": "0000866256",
"holder": "PARNASSUS INCOME FUNDS",
"securityCusip": "037833100",
"shares": 3638451,
"dateReported": "2026-06-30",
"change": -316881,
"weightPercent": 4.06607721
}
]常见问题解答(FAQ)
2 个问题想拉取「Fund Disclosures」相关数据,应该调公募基金与 ETF 披露(/stable/funds/disclosure-holders-latest)还是 公募基金披露?
公募基金与 ETF 披露 对应路径 /stable/funds/disclosure-holders-latest(必填 symbol),涵盖 holder(PARNASSUS INCOME FUNDS)、securityCusip(037833100)等 7 列;Mutual Fund Disclosures(公募基金披露) 对应 /stable/funds/disclosure(必填 symbol, year, quarter,共 23 列)。
如何基于 /stable/funds/disclosure-holders-latest 构建稳定的公募基金与 ETF 披露定时采集与历史补数任务?
回填或同步 公募基金与 ETF 披露 时,请传入目标证券 symbol 访问 /stable/funds/disclosure-holders-latest 采集单票数据;对返回的 holder(持有人)序列,建议先做排序核对再参与计算。
同模块相关接口对比
Fund Disclosures本接口路径 /stable/funds/disclosure-holders-latest,必填参数 symbol。 同一模块「Fund Disclosures」下共 4 个接口,下表列出其余 3 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 公募基金披露Mutual Fund Disclosures | /stable/funds/disclosure | 按目标股票代码反查持有该股的公募基金与 ETF 监管披露清单 |
| 基金ETF披露检索Mutual Fund & ETF Disclosure Name Search | /stable/funds/disclosure-holders-search | 按基金名称查找披露文件,返回基金代码、CIK、系列与类别 ID、申报文件编号及申报主体地址等关键信息 |
| 基金ETF按日披露Fund & ETF Disclosures by Date | /stable/funds/disclosure-dates | 按申报日期检索公募基金与 ETF 的披露文件,跟踪最新申报、回溯历史季度数据、监测申报趋势 |