Holder Performance Summary机构持股人业绩汇总
该接口从持仓角度评估机构投资者的表现:跟踪机构持股人的选股收益、组合变动和市值变化,并与标普 500 等基准做对比。
https://quote-fmp.com/stable/institutional-ownership/holder-performance-summary?cik=0001067983&page=0数据更新周期
N/A · 不适用固定周期
接口说明
- 机构投资者分析:从选股、持仓变动和市值三个维度评估机构投资者的表现,传入
cik后可呈现investorName(投资者名称)、portfolioSize(组合规模)与securitiesAdded(新增证券数) 等核心指标,辅助买方研究员快速核验标的基本面。 - 组合换手率分析:观察机构买卖证券的频率,洞察其交易策略风格,利用
portfolioSize(组合规模)与securitiesAdded(新增证券数) 等标准字段,可直接计算衍生比率或滚动窗口统计量。 - 业绩基准对比:在 1 年、3 年、5 年等不同时间跨度上,把机构表现与标普 500 等基准做对比,在搭建投研工作流时,建议配合「持股机构申报分析」同步拉取关联截面数据。
- 关联数据线接口:Industry Performance Summary(细分行业表现汇总) · Institutional Ownership Filings(机构持股申报) · CUSIP(CUSIP 检索) · Company Profile Data(公司概况)
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
cik | string | 必填 | 0001067983 | SEC Central Index Key(CIK)编号,用于定位公司 SEC 主体(须传补足前导零的 10 位定长字符串,如 "0000320193",切勿传整型) |
page | number | 可选 | 0 | 分页页码,从 0 开始,配合每页条数翻页取更多数据(从 0 起算的分页游标;当响应返回空数组 [] 时代表已翻至历史末页) |
调用代码示例
Python 关键代码针对机构持股人业绩汇总,向 /stable/institutional-ownership/holder-performance-summary 传入必填 cik后,响应提供 investorName(投资者名称)、portfolioSize(组合规模)、securitiesAdded(新增证券数)(样本 investorName=BERKSHIRE HATHAWAY INC)。
resp = requests.get(
"https://quote-fmp.com/stable/institutional-ownership/holder-performance-summary",
params={"cik": "0001067983", "page": 0, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 portfolioSize(组合规模)
df["portfolioSize"] = pd.to_numeric(df["portfolioSize"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按 10 位 CIK(0001067983)检索机构持股人业绩汇总 | cik=0001067983 | 向 /stable/institutional-ownership/holder-performance-summary 传补零 10 位 cik=0001067983,获取 investorName、portfolioSize、securitiesAdded(样本 investorName=BERKSHIRE HATHAWAY INC)。 |
| 切换代表性机构/主体(cik=0000320193)对比机构持股人业绩汇总 | cik=0000320193 | 改传 cik=0000320193 调用 /stable/institutional-ownership/holder-performance-summary,横向比较不同 SEC 申报主体的 investorName、portfolioSize、securitiesAdded。 |
机构持股人业绩汇总端点 /stable/institutional-ownership/holder-performance-summary(必填 cik)单次返回 investorName、portfolioSize、securitiesAdded 等 33 项属性;若带日期窗口查询,请确保起止日期为有效交易日。
在本地数据仓库归档机构持股人业绩汇总时,以 (cik, date) 去重可防止重跑产生脏数据;其中 portfolioSize(组合规模,如 29)为原始未缩写数值。
返回数据
33 个字段本接口示例响应共包含 33 个字段(数值型 30 个,文本/日期/布尔型 3 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2026-03-31" | 日期 |
cik | string | "0001067983" | SEC CIK 编号(SEC 10 位定长中央索引键,落库须定义为 VARCHAR(10) 字符串以防前导零丢失) |
investorName | string | "BERKSHIRE HATHAWAY INC" | 投资者名称 |
portfolioSize | number | 29 | 组合规模 |
securitiesAdded | number | 3 | 新增证券数 |
securitiesRemoved | number | 16 | 移除证券数 |
marketValue | number | 263095703570 | 持仓市值 |
previousMarketValue | number | 274160086701 | 上期持仓市值 |
changeInMarketValue | number | -11064383131 | 市值变动 |
changeInMarketValuePercentage | number | -4.0357 | 市值变动比例 |
averageHoldingPeriod | number | 19 | 平均持有期 |
averageHoldingPeriodTop10 | number | 32 | 前十大持仓平均持有期 |
averageHoldingPeriodTop20 | number | 25 | 前二十大持仓平均持有期 |
turnover | number | 0.6552 | 换手率 |
turnoverAlternateSell | number | 9.1702 | 换手率(按卖出口径) |
turnoverAlternateBuy | number | 5.8198 | 换手率(按买入口径) |
performance | number | -2243708176 | 业绩表现 |
performancePercentage | number | -0.8184 | 业绩表现(%) |
lastPerformance | number | 12155036983 | 最近一期业绩表现 |
changeInPerformance | number | -14398745159 | 业绩变动 |
performance1year | number | 28972527543 | 近一年业绩表现 |
performancePercentage1year | number | 11.3877 | 近一年业绩表现(%) |
performance3year | number | 118145912143 | 近三年业绩表现 |
performancePercentage3year | number | 45.9009 | 近三年业绩表现(%) |
performance5year | number | 146867544096 | 近五年业绩表现 |
performancePercentage5year | number | 63.1842 | 近五年业绩表现(%) |
performanceSinceInception | number | 267584180516 | 成立以来业绩表现 |
performanceSinceInceptionPercentage | number | 203.9112 | 成立以来业绩表现(%) |
performanceRelativeToSP500Percentage | number | 3.8118 | 相对标普 500 的超额收益(%) |
performance1yearRelativeToSP500Percentage | number | -4.9473 | 近一年相对标普 500 超额收益(%) |
performance3yearRelativeToSP500Percentage | number | -12.9708 | 近三年相对标普 500 超额收益(%) |
performance5yearRelativeToSP500Percentage | number | -1.1428 | 近五年相对标普 500 超额收益(%) |
performanceSinceInceptionRelativeToSP500Percentage | number | -114.003 | 成立以来相对标普 500 超额收益(%) |
查看响应数据示例(原始 JSON)
[
{
"date": "2026-03-31",
"cik": "0001067983",
"investorName": "BERKSHIRE HATHAWAY INC",
"portfolioSize": 29,
"securitiesAdded": 3,
"securitiesRemoved": 16,
"marketValue": 263095703570,
"previousMarketValue": 274160086701,
"changeInMarketValue": -11064383131,
"changeInMarketValuePercentage": -4.0357,
"averageHoldingPeriod": 19,
"averageHoldingPeriodTop10": 32,
"averageHoldingPeriodTop20": 25,
"turnover": 0.6552,
"turnoverAlternateSell": 9.1702,
"turnoverAlternateBuy": 5.8198,
"performance": -2243708176,
"performancePercentage": -0.8184,
"lastPerformance": 12155036983,
"changeInPerformance": -14398745159,
"performance1year": 28972527543,
"performancePercentage1year": 11.3877,
"performance3year": 118145912143,
"performancePercentage3year": 45.9009,
"performance5year": 146867544096,
"performancePercentage5year": 63.1842,内容已截断,完整字段以实际返回为准。
常见问题解答(FAQ)
2 个问题想拉取「Holder」相关数据,应该调机构持股人业绩汇总(/stable/institutional-ownership/holder-performance-summary)还是 持股机构申报分析?
机构持股人业绩汇总 对应路径 /stable/institutional-ownership/holder-performance-summary(必填 cik),涵盖 investorName(BERKSHIRE HATHAWAY INC)、portfolioSize(29)等 33 列;Filings Extract With Analytics By Holder(持股机构申报分析) 对应 /stable/institutional-ownership/extract-analytics/holder(必填 symbol, year, quarter,共 39 列)。
如何基于 /stable/institutional-ownership/holder-performance-summary 构建稳定的机构持股人业绩汇总定时采集与历史补数任务?
回填或同步 机构持股人业绩汇总 时,请向 /stable/institutional-ownership/holder-performance-summary 传分页参数并在收到空数组时终止循环;对返回的 investorName(投资者名称)序列,建议先做排序核对再参与计算。
同模块相关接口对比
Holder本接口路径 /stable/institutional-ownership/holder-performance-summary,必填参数 cik。 同一模块「Holder」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。