ETF Sector WeightingETF 板块权重

该接口返回一只 ETF 资产在各板块的配置占比。例如看好科技板块增长前景的投资者,可以选择科技板块敞口较高的 ETF。

GEThttps://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 个参数
参数类型要求示例说明
symbolstring必填SPYETF 或公募基金交易代码,例如 SPY(标普 500 ETF)、QQQ(纳指 100 ETF)、VOO、VWO。

调用代码示例

Python 关键代码

对接 /stable/etf/sector-weightings(ETF 板块权重,必填 symbol),从 DataFrame 可直接读取 sector(板块)、weightPercentage(权重(%))、symbol(证券代码)。

Python(核心参数与字段清洗逻辑)
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 传参约束:必填 symbol格式与 sector 校验

/stable/etf/sector-weightings 针对ETF 板块权重设计(必填 symbol),输出 sector(Basic Materials)等共 3 列,传参时请严格对齐必填 symbol示例。

落库主键与口径/stable/etf/sector-weightings 落库规范:主键取 (symbol, sector),校验 weightPercentage

/stable/etf/sector-weightings 共返回 3 列,入库 UPSERT 主键推荐取 (symbol, sector),并对 weightPercentage(1.6916311902850854) 执行 pd.to_numeric。

返回数据

3 个字段

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

字段类型示例值说明
symbolstring"SPY"证券代码
sectorstring"Basic Materials"板块
weightPercentagenumber1.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/holdingsETF 和公募基金持有资产的详细明细,每只成分证券的名称、代码、ISIN、市值与权重占比
ETF与基金资料ETF & Mutual Fund Information/stable/etf/infoETF 和公募基金的财务与结构信息,股票代码、基金名称、费率、管理规模等关键指标
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 监管披露清单

EtfAndMutualFunds(ETF 与基金)全部接口目录 →

需要稳定访问 ETF 板块权重 数据?注册即可获取专属 API Key,免费体验全部接口。
免费试用 1 个月