ETF Asset ExposureETF持仓分布查询
该接口提供被动型基金对单只底层股票的反向持仓敞口穿透查询。传入目标股票代码即可列出当前持有该标的的全部 ETF 名单、持有股数、持仓市值及占该基金净值的权重比例，适用于追踪被动资金买卖盘力量与权重股申赎冲击。
https://quote-fmp.com/stable/etf/asset-exposure?symbol=AAPL数据更新周期
N/A · 不适用固定周期
接口说明
- 个股被动资金溯源：传入单只股票代码即可反向检索出全市场所有持有该股票的 ETF 基金列表，帮助投研人员量化评估个股受被动指数基金申购与赎回驱动的潜在资金流敞口。
- 持仓权重与市值排序：逐行返回各只 ETF 对目标股票的持仓股数、对应持仓市值及占该 ETF 总资产的百分比权重，便于快速锁定对该股票边际定价权最大的头部宽基或行业主题 ETF。
- 再平衡冲击成本测算：在指数季度定期调样或行业 ETF 大额申赎窗口期，交易台可利用本接口披露的基金持仓集中度数据，提前预判被动调仓指令对个股尾盘流动性的冲击幅度。
- 配套投研接口：Mutual Fund & ETF Disclosure Name Search（基金ETF披露检索） · Fund & ETF Disclosures by Date（基金ETF按日披露） · ETF Symbol Search（ETF代码检索） · Stock Quote（股票报价）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 底层持仓股票代码，例如 AAPL、MSFT（用于按股票代码反向检索持有该标的的 ETF 或公募基金名单及权重）。 |
调用代码示例
Python 关键代码/stable/etf/asset-exposure 端点（ETF持仓分布查询）接收必填 symbol，返回 asset（资产名称）、sharesNumber（持股数量）、weightPercentage（权重（%）） 等 5 项指标。
resp = requests.get(
"https://quote-fmp.com/stable/etf/asset-exposure",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 sharesNumber（持股数量）
df["sharesNumber"] = pd.to_numeric(df["sharesNumber"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 查询 AAPL 的ETF持仓分布查询明细（symbol=AAPL） | symbol=AAPL | 向 /stable/etf/asset-exposure 传 symbol=AAPL，返回包含 asset、sharesNumber、weightPercentage（如 asset=AAPL）在内的 5 项字段。 |
| 切换美股龙头 NVDA 对比ETF持仓分布查询 | symbol=NVDA | 改用 symbol=NVDA 调用 /stable/etf/asset-exposure，提取 NVDA 的 asset、sharesNumber、weightPercentage 与 AAPL 横向对标。 |
从 /stable/etf/asset-exposure 采集ETF持仓分布查询（必填 symbol）后，可获得 asset（样本 AAPL）；生产脚本中切勿对空 DataFrame 直接按列名索引。
处理 /stable/etf/asset-exposure 下发的ETF持仓分布查询记录时，以 (symbol) 作为 Upsert 冲突键，同时核对 sharesNumber（42372）的数值单位。
返回数据
5 个字段本接口示例响应共包含 5 个字段（数值型 3 个，文本/日期/布尔型 2 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "ZWT-T.TO" | 证券代码 |
asset | string | "AAPL" | 资产名称 |
sharesNumber | number | 42372 | 持股数量 |
weightPercentage | number | 10.100000000000001 | 权重（%） |
marketValue | number | 20141231.66 | 持仓市值 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "ZWT-T.TO",
"asset": "AAPL",
"sharesNumber": 42372,
"weightPercentage": 10.100000000000001,
"marketValue": 20141231.66
}
]常见问题解答（FAQ）
2 个问题ETF持仓分布查询和 ETF与基金持仓明细 属于同一模块，两者的查询键与核心产出字段如何区分？
区分方式很简单：需要 asset（资产名称）和 sharesNumber（持股数量）这 5 项字段时请求 /stable/etf/asset-exposure（必填 symbol）；需要 ETF & Fund Holdings（ETF与基金持仓明细） 的 9 项字段时请求 /stable/etf/holdings（必填 symbol）。
在设计ETF持仓分布查询（/stable/etf/asset-exposure）的数据拉取管道时，怎样避免单次请求跨度过大或遗漏？
实盘中推荐在 /stable/etf/asset-exposure 中指定 symbol（跨市场代码须保留后缀）；通过规范化参数边界，可让 /stable/etf/asset-exposure 稳定产出 asset（资产名称）等核心业务指标。
同模块相关接口对比
Holdings本接口路径 /stable/etf/asset-exposure，必填参数 symbol。 同一模块「Holdings」下共 4 个接口，下表列出其余 3 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| ETF与基金持仓明细ETF & Fund Holdings | /stable/etf/holdings | ETF 和公募基金持有资产的详细明细，每只成分证券的名称、代码、ISIN、市值与权重占比 |
| ETF与基金资料ETF & Mutual Fund Information | /stable/etf/info | ETF 和公募基金的财务与结构信息，股票代码、基金名称、费率、管理规模等关键指标 |
| ETF 基金国家配置ETF & Fund Country Allocation | /stable/etf/country-weightings | 指定 ETF 或公募基金在全球各国家与地区的资产配置权重分布 |