ETF Holder BulkETF持股批量查询

该接口返回 ETF 持仓资产的详细清单：每项资产的持股数量、权重占比、市值，以及 ISIN、CUSIP 等识别码，便于分析 ETF 的资产构成。

GEThttps://quote-fmp.com/stable/etf-holder-bulk?part=1

数据更新周期

4-6 Hours

接口说明

持股信息：查看 ETF 对每项资产的持股数量，清晰呈现持仓分布，传入 part 后可下发 name（名称）、sharesNumber（持股数量）与 asset（资产名称）等标准化字段，可无缝接入实盘风控与预警系统。
权重占比：分析每项资产在 ETF 中的权重，帮助投资者理解其对 ETF 整体价值的贡献，汇总 sharesNumber（持股数量）与 asset（资产名称）等字段信息，方便输出标准化的个股或资产深度研究底稿。
市值业务定位：获取 ETF 所持各项资产的最新市值，完整呈现 ETF 的构成，通过单次 CSV 流式响应完成全市场数万标的截面同步。
流式导出响应：调用 /stable/etf-holder-bulk 获取ETF持股批量查询时返回标准 CSV 流，切勿调用 resp.json()，推荐解析后直接存为本地 Parquet 分区文件。
跨模块关联接口：Cash Flow Statement Growth Bulk（现金流量表增长批量数据） · Eod Bulk（日线行情批量） · Stock Price and Volume Data（日线完整行情） · Company Profile Data（公司概况）

请求参数

1 个参数

参数	类型	要求	示例	说明
`part`	string	必填	`1`	SEC 文件的分册编号。

调用代码示例

Python 关键代码

/stable/etf-holder-bulk 单次流式返回全市场ETF持股批量查询（含 name（名称）、sharesNumber（持股数量）、asset（资产名称）），不可调 resp.json()，建议用 pd.read_csv 解析后存为 Parquet。

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

import io
resp = requests.get(
    "https://quote-fmp.com/stable/etf-holder-bulk",
    params={"part": "1", "apikey": FMP_KEY},
    timeout=60,
)
resp.raise_for_status()
# ETF持股批量查询返回 CSV 文本流，使用 io.StringIO 配合 pd.read_csv 解析
df = pd.read_csv(io.StringIO(resp.text))
df["sharesNumber"] = pd.to_numeric(df["sharesNumber"], errors="coerce")

参数使用和避坑

2 组参数组合 · 2 条避坑

以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：

投研场景	Query 参数组合示例	返回数据特征与用途
按 part=1 拉取ETF持股批量查询	`part=1`	向 /stable/etf-holder-bulk 传 part=1，提取匹配的 name、sharesNumber、asset（如 name=SAMSUNG ELECTRO MECHANIC…）。
切换 part=MSFT 查询ETF持股批量查询	`part=MSFT`	改传 part=MSFT 访问 /stable/etf-holder-bulk，对比不同过滤条件下的 name、sharesNumber、asset。

CSV 流式解析ETF持股批量查询：/stable/etf-holder-bulk 下发 CSV 文本流，切勿调 resp.json()

ETF持股批量查询接口 /stable/etf-holder-bulk 采用 CSV 流格式下发 name（SAMSUNG ELECTRO MECHANIC…）等全市场截面，请求时建议设 timeout=60 并以 io.StringIO 解析。

落库主键与口径持久化ETF持股批量查询：以 (symbol, cusip, isin) 建键并规范 sharesNumber 类型

清洗ETF持股批量查询响应时，先按 (symbol, cusip, isin) 剔除重复行，再提取 sharesNumber（持股数量，样本 15514）构造量化指标。

返回数据

9 个字段

本接口示例响应共包含 9 个字段（数值型 0 个，文本/日期/布尔型 9 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。

字段	类型	示例值	说明
`symbol`	string	`"EXCH.AS"`	证券代码
`name`	string	`"SAMSUNG ELECTRO MECHANICS LTD"`	名称
`sharesNumber`	string	`"15514"`	持股数量
`asset`	string	`"009150.KS"`	资产名称
`weightPercentage`	string	`"0.09611"`	权重（%）
`cusip`	string	`""`	CUSIP 代码
`isin`	string	`"KR7009150004"`	国际证券识别码
`marketValue`	string	`"1553142.49"`	持仓市值
`lastUpdated"`	string	`"2024-09-06""`	最近更新时间（FMP 源字段名与取值均多带一个引号）

查看响应数据示例（原始 JSON）

[
{
"symbol": "EXCH.AS",
"name": "SAMSUNG ELECTRO MECHANICS LTD",
"sharesNumber": "15514",
"asset": "009150.KS",
"weightPercentage": "0.09611",
"cusip": "",
"isin": "KR7009150004",
"marketValue": "1553142.49",
"lastUpdated\"": "2024-09-06\""
}
]

常见问题解答（FAQ）

2 个问题

请求 /stable/etf-holder-bulk 获取ETF持股批量查询时有哪些必填项？它与公司概况批量的边界在哪？

ETF持股批量查询（/stable/etf-holder-bulk）采用必填 part查询，返回首条样本如 name=SAMSUNG ELECTRO MECHANIC…（共 9 列）；同模块相邻的 Company Profile Bulk（公司概况批量）则包含 36 列。

初次建库回填ETF持股批量查询与日常增量拉取 /stable/etf-holder-bulk，在传参方式上有何技巧？

在量化管道中，应按 part 过滤条件请求 /stable/etf-holder-bulk 并做非空校验；若并发拉取多组任务，请结合网关 RPM 配额控制并发协程数，稳健采集 name。

同模块相关接口对比

Profile

本接口路径 /stable/etf-holder-bulk，必填参数 part。同一模块「Profile」下共 11 个接口，下表列出其余 10 个，按粒度与查询维度对比，避免选错接口。

接口	路径	核心差异与适用场景
公司概况批量Company Profile Bulk	`/stable/profile-bulk`	以 CSV 流式分片形式一次性返回全市场上市公司的档案主表
评级批量Stock Rating Bulk	`/stable/rating-bulk`	以单次 CSV 流式响应批量导出全市场股票的综合财务评级快照
DCF 批量估值DCF Valuations Bulk	`/stable/dcf-bulk`	一次请求即可返回多个代码的现金流折现（DCF）估值，含隐含价格变动空间与百分比差异
财务评分批量Financial Scores Bulk	`/stable/scores-bulk`	以单次 CSV 流式响应批量返回全市场股票的 Piotroski F-Score与 Altman Z-Score截面
目标价汇总批量Price Target Summary Bulk	`/stable/price-target-summary-bulk`	以单次 CSV 流式响应批量导出全市场覆盖股票的分析师目标价汇总截面
评级共识批量数据Upgrades Downgrades Consensus Bulk	`/stable/upgrades-downgrades-consensus-bulk`	批量获取全部股票代码的分析师评级总览，一次请求即可拿到分析师上调评级、下调评级与共识推荐
TTM 关键指标批量Key Metrics TTM Bulk	`/stable/key-metrics-ttm-bulk`	以单次 CSV 流式响应批量导出全市场上市公司的滚动十二个月（TTM）关键财务指标截面
TTM 财务比率批量Ratios TTM Bulk	`/stable/ratios-ttm-bulk`	以单次 CSV 流式响应批量导出全市场上市公司的滚动十二个月（TTM）财务比率截面
同业公司批量Stock Peers Bulk	`/stable/peers-bulk`	以单次 CSV 流式响应批量导出全市场上市公司的同行业可比公司映射全表
批量财报超预期Earnings Surprises Bulk	`/stable/earnings-surprises-bulk`	一次返回多家公司年度财报意外数据，实际 EPS 与预期 EPS 对比

Bulk（批量数据）全部接口目录 →

需要稳定访问 ETF持股批量查询数据？注册即可获取专属 API Key，免费体验全部接口。

免费试用 1 个月