Holders Industry Breakdown机构持股行业分布
该接口展示机构投资者在各板块和细分行业上的配置：各行业持仓权重及其随时间的变化，用于分析机构的行业侧重与投资策略演变。
https://quote-fmp.com/stable/institutional-ownership/holder-industry-breakdown?cik=0001067983&year=2023&quarter=3数据更新周期
N/A · 不适用固定周期
接口说明
- 行业侧重分析：了解主要机构持股人的资金集中投向哪些行业，传入
cik后可下发investorName（投资者名称）、industryTitle（行业分类名称）与weight（权重） 等标准化字段，可无缝接入实盘风控与预警系统。 - 组合分散度：分析机构投资者的投资组合在不同板块间的分散程度，基于
industryTitle（行业分类名称）与weight（权重） 等核心指标，省去多源报表口径折算与人工核对环节。 - 投资趋势洞察：跟踪各行业持仓权重的变化，识别机构投资策略的转向，工程落库阶段可与「机构持股人业绩汇总」共用主键索引，形成完整的专题数据集。
- 上下游关联接口：Form 13F Filings Dates（13F申报日期查询） · Positions Summary（机构持仓汇总） · Company Profile Data（公司概况） · SEC Filings By CIK（按 CIK 查 SEC 申报）
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
cik | string | 必填 | 0001067983 | SEC Central Index Key（CIK）编号，用于定位公司 SEC 主体（须传补足前导零的 10 位定长字符串，如 "0000320193"，切勿传整型） |
year | string | 必填 | 2023 | 目标财报/数据的年份，如 2023。 |
quarter | string | 必填 | 3 | 目标季度，1、2、3、4 分别对应 Q1~Q4。 |
调用代码示例
Python 关键代码访问 /stable/institutional-ownership/holder-industry-breakdown 获取机构持股行业分布（必填 cik, year, quarter），单条记录含 investorName（投资者名称）、industryTitle（行业分类名称）、weight（权重） 等 12 个字段。
resp = requests.get(
"https://quote-fmp.com/stable/institutional-ownership/holder-industry-breakdown",
params={"cik": "0001067983", "year": "2023", "quarter": "3", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 weight（权重）
df["weight"] = pd.to_numeric(df["weight"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按 10 位 CIK（0001067983）检索机构持股行业分布 | cik=0001067983&year=2023&quarter=3 | 向 /stable/institutional-ownership/holder-industry-breakdown 传补零 10 位 cik=0001067983，获取 investorName、industryTitle、weight（样本 investorName=BERKSHIRE HATHAWAY INC）。 |
| 切换代表性机构/主体（cik=0000320193）对比机构持股行业分布 | cik=0000320193&year=2023&quarter=3 | 改传 cik=0000320193 调用 /stable/institutional-ownership/holder-industry-breakdown，横向比较不同 SEC 申报主体的 investorName、industryTitle、weight。 |
| 回溯 2024Q4 历史季末机构持股行业分布截面 | cik=0001067983&year=2024&quarter=Q4 | 指定 year=2024&quarter=Q4，还原 0001067983 在历史季末的 investorName、industryTitle、weight 明细。 |
访问 /stable/institutional-ownership/holder-industry-breakdown 提取机构持股行业分布（必填 cik, year, quarter），单条 JSON 含 investorName（BERKSHIRE HATHAWAY INC）、industryTitle（ELECTRONIC COMPUTERS）等 12 个字段，空列表响应代表该条件下无披露记录。
从 /stable/institutional-ownership/holder-industry-breakdown 抽取 weight（样本 49.7704）入库时，以 (cik, industryTitle, date) 建唯一索引可安全支持断点续传。
返回数据
12 个字段本接口示例响应共包含 12 个字段（数值型 8 个，文本/日期/布尔型 4 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2023-09-30" | 日期 |
cik | string | "0001067983" | SEC CIK 编号（SEC 10 位定长中央索引键，落库须定义为 VARCHAR(10) 字符串以防前导零丢失） |
investorName | string | "BERKSHIRE HATHAWAY INC" | 投资者名称 |
industryTitle | string | "ELECTRONIC COMPUTERS" | 行业分类名称 |
weight | number | 49.7704 | 权重 |
lastWeight | number | 51.0035 | 最近权重 |
changeInWeight | number | -1.2332 | 权重变动 |
changeInWeightPercentage | number | -2.4178 | 权重变动比例 |
performance | number | -20838154294 | 业绩表现 |
performancePercentage | number | -178.2938 | 业绩表现（%） |
lastPerformance | number | 26615340304 | 最近一期业绩表现 |
changeInPerformance | number | -47453494598 | 业绩变动 |
查看响应数据示例（原始 JSON）
[
{
"date": "2023-09-30",
"cik": "0001067983",
"investorName": "BERKSHIRE HATHAWAY INC",
"industryTitle": "ELECTRONIC COMPUTERS",
"weight": 49.7704,
"lastWeight": 51.0035,
"changeInWeight": -1.2332,
"changeInWeightPercentage": -2.4178,
"performance": -20838154294,
"performancePercentage": -178.2938,
"lastPerformance": 26615340304,
"changeInPerformance": -47453494598
}
]常见问题解答（FAQ）
2 个问题如何区分「Holder」模块的机构持股行业分布与 持股机构申报分析？/stable/institutional-ownership/holder-industry-breakdown 的传参要求是什么？
两者的差异在于入口与字段集：/stable/institutional-ownership/holder-industry-breakdown（机构持股行业分布）要求必填 cik, year, quarter并产出 12 列（含 investorName=BERKSHIRE HATHAWAY INC）；Filings Extract With Analytics By Holder（持股机构申报分析）要求必填 symbol, year, quarter并产出 39 列。
拉取 /stable/institutional-ownership/holder-industry-breakdown 的机构持股行业分布数据时，如何处理历史回溯、空结果判定或代码格式？
针对 /stable/institutional-ownership/holder-industry-breakdown，推荐传入精确匹配的 cik 参数调用 /stable/institutional-ownership/holder-industry-breakdown；这样既能稳定获取 investorName（投资者名称），又能避免单次请求载荷过大。
同模块相关接口对比
Holder本接口路径 /stable/institutional-ownership/holder-industry-breakdown，必填参数 cik、year、quarter。 同一模块「Holder」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。