EtfAndMutualFunds（ETF 与基金）

此类接口提供 ETF 与基金的持仓穿透信息，包括持仓明细、行业权重、国家与地区配置、资产类别敞口和规模费用等基本资料，以及按名称、日期或 CIK 检索的监管披露文件。做组合穿透、指数复制、风格暴露检查都从这里取数；持仓按季度或月度披露，存在一定滞后。

典型使用场景

3 个场景

组合穿透

把多只 ETF 展开到底层标的，计算真实集中度。

风格判断

用行业与地区权重判断基金的实际风格漂移。

基金筛选

按费率、规模与持仓特征筛选候选基金。

接口怎么选？

7 项选型对照

基金类别有两条主线：一条看「基金里装了什么」（持仓、行业权重、国家配置、资产暴露），一条看「基金披露了什么」（N-PORT 类文件与持股人信息）。

持仓数据存在披露滞后，权重按披露日市值计算，市场波动会让实际权重快速偏离披露值。做穿透分析时要标注数据快照日期。

你的需求	推荐接口	选择理由
看 ETF 里持有哪些成分股	ETF & Fund HoldingsETF与基金持仓明细	逐只成分与权重，做穿透和重叠度分析
查基金基本信息与费率	ETF & Mutual Fund InformationETF与基金资料	含规模、费率、成立日与发行人等静态信息
看行业权重分布	ETF Sector WeightingETF 板块权重	判断基金的行业集中度
看地区或国家配置	ETF & Fund Country AllocationETF 基金国家配置	做地域暴露与汇率风险判断
看资产类别暴露	ETF Asset ExposureETF持仓分布查询	区分股票、债券、现金等大类占比
读基金定期披露文件	Mutual Fund Disclosures公募基金披露	N-PORT 类披露，含完整持仓明细
按机构名反查持有哪些基金	Mutual Fund & ETF Disclosure Name Search基金ETF披露检索	从管理人或持股人维度反查

数据覆盖与参数口径

覆盖范围：以美国上市 ETF 与共同基金为主
持仓时效：按监管披露周期更新，存在明显滞后
权重口径：按披露日市值计算，实际权重随行情漂移
双重计数：同一标的可能通过不同份额类别重复出现，聚合前要识别
费用字段：费率口径（管理费 vs 总费用率）不同，跨基金比较要统一

调用示例

Python 关键代码

示例场景：拉取 ETF 成分持仓 · 对应接口：ETF & Fund Holdings（ETF与基金持仓明细）

Python（核心参数与字段清洗逻辑）

resp = requests.get(
    "https://quote-fmp.com/stable/etf/holdings",
    params={"symbol": "SPY", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 updatedAt 升序重排并数值化 sharesNumber（持股数量）
df["sharesNumber"] = pd.to_numeric(df["sharesNumber"], errors="coerce")
df = df.sort_values("updatedAt").reset_index(drop=True)

保存披露日期，权重是快照值而非实时值。
同一标的多份额类别要先合并再算集中度。

数据注意事项

4 条实盘要点

ETF & Fund Holdings（ETF与基金持仓明细）返回的 updatedAt 代表持仓披露快照时间，穿透分析时应记录该时间戳，不可当作盘中实时权重。
基金基础资料（费率 expenseRatio、资产规模 aum、跟踪指数）统一从 ETF & Mutual Fund Information（ETF与基金资料）获取，行业与地区暴露则分别调 ETF Sector Weighting（ETF 板块权重）与 ETF & Fund Country Allocation（ETF 基金国家配置）。
反查某只股票被哪些 ETF 重仓持有、占多少权重，直接调用 ETF Asset Exposure（ETF持仓分布查询）传入个股 symbol。
需要审计共同基金与 ETF 的 SEC N-PORT 官方季度持仓申报时，组合使用 Mutual Fund & ETF Disclosure Name Search（基金ETF披露检索）与 Mutual Fund Disclosures（公募基金披露）。