ETF Sector WeightingETF 板块权重
该接口返回一只 ETF 资产在各板块的配置占比。例如看好科技板块增长前景的投资者,可以选择科技板块敞口较高的 ETF。
https://quote-fmp.com/stable/etf/sector-weightings?symbol=SPY数据更新周期
12 Hours
接口说明
- 分析板块敞口:了解 ETF 资产在科技、医疗保健、必需消费等板块的配置,理解其风险特征,传入
symbol后可调取sector(板块)、weightPercentage(权重(%)) 等核心数值,方便与本地历史研究库按主键对齐。 - 找到行业主题 ETF:找到与自身投资逻辑相符、对特定板块敞口显著的 ETF。例如看好科技板块的强劲增长,可选择科技板块配置较高的 ETF。
- 分散投资组合:利用板块权重数据,选择能补足自身配置不足板块的 ETF,平衡整体风险,适合纳入每日定时同步管道,为策略信号生成与风险监控提供稳定数据支撑。
- 上下游关联接口:ETF & Fund Holdings(ETF与基金持仓明细) · ETF & Mutual Fund Information(ETF与基金资料) · Eod Bulk(日线行情批量) · Company Profile Data(公司概况)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | SPY | ETF 或公募基金交易代码,例如 SPY(标普 500 ETF)、QQQ(纳指 100 ETF)、VOO、VWO。 |
调用代码示例
Python 关键代码对接 /stable/etf/sector-weightings(ETF 板块权重,必填 symbol),从 DataFrame 可直接读取 sector(板块)、weightPercentage(权重(%))、symbol(证券代码)。
resp = requests.get(
"https://quote-fmp.com/stable/etf/sector-weightings",
params={"symbol": "SPY", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 weightPercentage(权重(%))
df["weightPercentage"] = pd.to_numeric(df["weightPercentage"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 查询 SPY 的基金板块权重 | symbol=SPY | 向 /stable/etf/sector-weightings 传入基金代码 SPY。按 sector 对齐 weightPercentage 后比较板块配置;比较前核对快照时点,不以字段排序位置连接两张表。 |
| 切换 QQQ 比较两只基金的基金板块权重 | symbol=QQQ | 保持接口不变,将基金代码改为 QQQ,与 SPY 按业务字段对齐。先从基金目录确认代码及覆盖,返回空数组时不要改用成分股 NVDA 代替基金。 |
/stable/etf/sector-weightings 针对ETF 板块权重设计(必填 symbol),输出 sector(Basic Materials)等共 3 列,传参时请严格对齐必填 symbol示例。
/stable/etf/sector-weightings 共返回 3 列,入库 UPSERT 主键推荐取 (symbol, sector),并对 weightPercentage(1.6916311902850854) 执行 pd.to_numeric。
返回数据
3 个字段本接口示例响应共包含 3 个字段(数值型 1 个,文本/日期/布尔型 2 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "SPY" | 证券代码 |
sector | string | "Basic Materials" | 板块 |
weightPercentage | number | 1.6916311902850854 | 权重(%) |
查看响应数据示例(原始 JSON)
[
{
"symbol": "SPY",
"sector": "Basic Materials",
"weightPercentage": 1.6916311902850854
}
]常见问题解答(FAQ)
2 个问题为什么「Holding」同时提供ETF 板块权重(/stable/etf/sector-weightings)和 ETF与基金持仓明细(/stable/etf/holdings)两个端点?
/stable/etf/sector-weightings(ETF 板块权重,必填 symbol)专门针对 sector(板块)与 symbol(证券代码)等 3 个字段建模;若要结合 ETF & Fund Holdings(ETF与基金持仓明细),可再调 /stable/etf/holdings(必填 symbol)。
在量化生产环境中,如何高效拉取ETF 板块权重(/stable/etf/sector-weightings)的历史序列或批量截面?
建议向 /stable/etf/sector-weightings 传入标准 symbol(港股带 .HK、A 股带 .SS);拿到 sector(板块)等数据后,先校验 len(data) > 0 再送入下游清洗管道。
同分类关联接口对比
ETF 与基金本接口路径 /stable/etf/sector-weightings(所属子模块「Holding」仅此 1 个接口),必填参数 symbol。 下表列出同属「ETF 与基金」大类下的 6 个关联接口,方便横向对比与上下游联动:
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 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 或公募基金在全球各国家与地区的资产配置权重分布 |
| ETF持仓分布查询ETF Asset Exposure | /stable/etf/asset-exposure | 被动型基金对单只底层股票的反向持仓敞口穿透查询 |
| 公募基金与 ETF 披露Mutual Fund & ETF Disclosure | /stable/funds/disclosure-holders-latest | 按基金或 ETF 代码与报告期查询 SEC N-PORT 监管披露的底层持仓明细 |
| 公募基金披露Mutual Fund Disclosures | /stable/funds/disclosure | 按目标股票代码反查持有该股的公募基金与 ETF 监管披露清单 |