ETF & Fund Country AllocationETF 基金国家配置
该接口返回指定 ETF 或公募基金在全球各国家与地区的资产配置权重分布。按国家或地区维度汇总持仓市值占基金总净值的百分比，帮助全球宏观与多资产配置团队直观评估跨境基金的地缘敞口与汇率风险。
https://quote-fmp.com/stable/etf/country-weightings?symbol=SPY数据更新周期
N/A · 不适用固定周期
接口说明
- 全球地域敞口透视：将单只 ETF 或公募基金的底层持仓按所属国家与地区归集为标准化权重百分比，清晰揭示跨国基金在北美、欧洲、亚太及新兴市场的真实地域分布结构。
- 主权与汇率风险剥离：在构建全球多资产配置组合时，投研团队可通过本接口汇总多只基金的底层国家权重，避免因重复配置同类跨国指数基金而造成单一国家或单一非美货币风险过度集中。
- 新兴市场与主题筛选：配合基金行业配置与底层持仓明细接口，买方机构能够快速筛选出在特定高景气国家或区域具备高纯度敞口的工具型 ETF，提升跨境宏观策略的执行效率。
- 关联数据线接口：Mutual Fund & ETF Disclosure（公募基金与 ETF 披露） · Mutual Fund Disclosures（公募基金披露） · Eod Bulk（日线行情批量） · Company Profile Data（公司概况）
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | SPY | ETF 或公募基金交易代码，例如 SPY（标普 500 ETF）、QQQ（纳指 100 ETF）、VOO、VWO。 |
调用代码示例
Python 关键代码在 Python 中调用 ETF 基金国家配置（/stable/etf/country-weightings，必填 symbol），可提取 country（国家/地区）、weightPercentage（权重（%））（country=United States）。
resp = requests.get(
"https://quote-fmp.com/stable/etf/country-weightings",
params={"symbol": "SPY", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 ETF 基金国家配置 核心列：country, weightPercentage
df = df[["country", "weightPercentage"]].dropna(how="all")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 查询 SPY 的基金国家配置 | symbol=SPY | 向 /stable/etf/country-weightings 传入基金代码 SPY。按 country 对齐 weightPercentage，缺失国家不直接补成零；先确认百分比字符串的单位再计算差值。 |
| 切换 QQQ 比较两只基金的基金国家配置 | symbol=QQQ | 保持接口不变，将基金代码改为 QQQ，与 SPY 按业务字段对齐。先从基金目录确认代码及覆盖，返回空数组时不要改用成分股 NVDA 代替基金。 |
使用 /stable/etf/country-weightings 同步ETF 基金国家配置（必填 symbol）时，country（国家/地区）为关键业务列；多次拉取或增量合并时请按主键去重。
对ETF 基金国家配置（/stable/etf/country-weightings）执行增量 ETL 时，通过 (country) 唯一约束幂等写入，并对 country（国家/地区）做非空与字符集清洗。
返回数据
2 个字段本接口示例响应共包含 2 个字段（数值型 0 个，文本/日期/布尔型 2 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
country | string | "United States" | 国家/地区 |
weightPercentage | string | "97.26%" | 权重（%） |
查看响应数据示例（原始 JSON）
[
{
"country": "United States",
"weightPercentage": "97.26%"
}
]常见问题解答（FAQ）
2 个问题投研选型时，什么场景用ETF 基金国家配置（/stable/etf/country-weightings），什么场景改用 ETF与基金持仓明细？
当您需要 country（国家/地区，如 United States）与 weightPercentage（权重（%））时调 ETF 基金国家配置（/stable/etf/country-weightings，必填 symbol）；反之若侧重 ETF & Fund Holdings（ETF与基金持仓明细） 的维度，则请求 /stable/etf/holdings（必填 symbol）。
在脚本里循环或定时请求 /stable/etf/country-weightings（ETF 基金国家配置）时，有哪些调度细节要注意？
在脚本编排上，建议传入目标证券 symbol 访问 /stable/etf/country-weightings 采集单票数据；将每次从 /stable/etf/country-weightings 拿到的 country（国家/地区）按批次追加至本地历史表。
同模块相关接口对比
Holdings本接口路径 /stable/etf/country-weightings，必填参数 symbol。 同一模块「Holdings」下共 4 个接口，下表列出其余 3 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| ETF与基金持仓明细ETF & Fund Holdings | /stable/etf/holdings | ETF 和公募基金持有资产的详细明细，每只成分证券的名称、代码、ISIN、市值与权重占比 |
| ETF与基金资料ETF & Mutual Fund Information | /stable/etf/info | ETF 和公募基金的财务与结构信息，股票代码、基金名称、费率、管理规模等关键指标 |
| ETF持仓分布查询ETF Asset Exposure | /stable/etf/asset-exposure | 被动型基金对单只底层股票的反向持仓敞口穿透查询 |