Filings Extract With Analytics By Holder持股机构申报分析
该接口对机构投资者的申报文件做量化拆解，返回持股数量、权重与市值变动、持股占比等指标，帮助理解机构的投资行为并跟踪重要股权变化。
https://quote-fmp.com/stable/institutional-ownership/extract-analytics/holder?symbol=AAPL&year=2023&quarter=3&page=0&limit=10数据更新周期
N/A · 不适用固定周期
接口说明
- 机构投资者分析：跟踪 Vanguard 等大型机构持股人的行为，包括其股票持仓和市值的变化，传入
symbol后可拿到investorName（投资者名称）、securityName（证券名称）与typeOfSecurity（证券种类） 等明细项，便于在 Python 或 SQL 中直接聚合。 - 组合变动监控：分析股票进出和持有期数据，了解机构持有一只股票的时间长短，以及何时加减仓，借助
securityName（证券名称）与typeOfSecurity（证券种类） 等数值，方便研究员在长周期序列上识别趋势拐点。 - 投资策略洞察：通过权重、市值和持股占比随时间的变化，理解机构的投资策略，若需补充上下文维度，可搭配同模块的「机构持股行业分布」交叉比对核心指标。
- 上下游关联接口：Institutional Ownership Filings（机构持股申报） · Filings Extract（SEC申报文件提取） · Search Cik（CIK 检索） · CUSIP（CUSIP 检索）
请求参数
5 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 美国 SEC 监管申报或美股上市公司股票代码，例如 AAPL、MSFT、NVDA（仅覆盖美股及在美上市 ADR，无需附加交易所后缀）。 |
year | string | 必填 | 2023 | 目标财报/数据的年份，如 2023。 |
quarter | string | 必填 | 3 | 目标季度，1、2、3、4 分别对应 Q1~Q4。 |
page | number | 可选 | 0 | 分页页码，从 0 开始，配合每页条数翻页取更多数据（从 0 起算的分页游标；当响应返回空数组 [] 时代表已翻至历史末页） |
limit | number | 可选 | 10 | 返回结果条数上限，用于控制单次响应大小。 |
调用代码示例
Python 关键代码持股机构申报分析（/stable/institutional-ownership/extract-analytics/holder，必填 symbol, year, quarter）返回 investorName（投资者名称）、securityName（证券名称）、typeOfSecurity（证券种类） 等 39 列（样本 investorName=VANGUARD GROUP INC）。
resp = requests.get(
"https://quote-fmp.com/stable/institutional-ownership/extract-analytics/holder",
params={"symbol": "AAPL", "year": "2023", "quarter": "3", "page": 0, "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 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 定向上游请求 AAPL 持股机构申报分析（symbol=AAPL） | symbol=AAPL&year=2023&quarter=3 | 请求 /stable/institutional-ownership/extract-analytics/holder?symbol=AAPL，产出该标的的 investorName、securityName、typeOfSecurity（样本 VANGUARD GROUP INC）等 39 列明细。 |
| 带容量上限参数（limit=100）采集 AAPL 持股机构申报分析 | symbol=AAPL&year=2023&quarter=3&page=0&limit=100 | 在 /stable/institutional-ownership/extract-analytics/holder 请求中显式声明容量上限，批量归档 AAPL 的 investorName、securityName、typeOfSecurity（样本 VANGUARD GROUP INC）。 |
| 拉取 NVDA 的持股机构申报分析做同业对标 | symbol=NVDA&year=2023&quarter=3 | 通过 symbol=NVDA 请求 /stable/institutional-ownership/extract-analytics/holder，拉回 持股机构申报分析 的 investorName、securityName、typeOfSecurity 明细数据。 |
请求 /stable/institutional-ownership/extract-analytics/holder 获取持股机构申报分析需传入必填 symbol, year, quarter；返回数组涵盖 investorName（VANGUARD GROUP INC）与 securityName（APPLE INC），做时间序列差分前请先核对排序方向。
在 /stable/institutional-ownership/extract-analytics/holder 的返回结构中，investorName（VANGUARD GROUP INC）与 weight（5.4673）构成核心载荷，本地表以 (symbol, cik, industryTitle) 保证幂等入库。
返回数据
39 个字段本接口示例响应共包含 39 个字段（数值型 23 个，文本/日期/布尔型 16 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2023-09-30" | 日期 |
cik | string | "0000102909" | SEC CIK 编号（SEC 10 位定长中央索引键，落库须定义为 VARCHAR(10) 字符串以防前导零丢失） |
filingDate | string | "2023-12-18" | 申报日期（监管申报日期；若同表含 acceptedDate，实盘事件对齐应优先取 acceptedDate） |
investorName | string | "VANGUARD GROUP INC" | 投资者名称 |
symbol | string | "AAPL" | 证券代码 |
securityName | string | "APPLE INC" | 证券名称 |
typeOfSecurity | string | "COM" | 证券种类 |
securityCusip | string | "037833100" | 证券 CUSIP 代码 |
sharesType | string | "SH" | 股份类型代码（如 SH） |
putCallShare | string | "Share" | 看跌看涨占比 |
investmentDiscretion | string | "SOLE" | 投资决策权（如 SOLE） |
industryTitle | string | "ELECTRONIC COMPUTERS" | 行业分类名称 |
weight | number | 5.4673 | 权重 |
lastWeight | number | 5.996 | 最近权重 |
changeInWeight | number | -0.5287 | 权重变动 |
changeInWeightPercentage | number | -8.8175 | 权重变动比例 |
marketValue | number | 222572509140 | 持仓市值 |
lastMarketValue | number | 252876459509 | 最近持仓市值 |
changeInMarketValue | number | -30303950369 | 市值变动 |
changeInMarketValuePercentage | number | -11.9837 | 市值变动比例 |
sharesNumber | number | 1299997133 | 持股数量 |
lastSharesNumber | number | 1303688506 | 最近一次持股数量 |
changeInSharesNumber | number | -3691373 | 持股数量变动 |
changeInSharesNumberPercentage | number | -0.2831 | 持股数量变动比例 |
quarterEndPrice | number | 171.21 | 季末价格 |
avgPricePaid | number | 20.65 | 平均买入价 |
isNew | boolean | false | 是否新建仓 |
isSoldOut | boolean | false | 是否已清仓 |
ownership | number | 8.3336 | 持股情况 |
lastOwnership | number | 8.305 | 最近持股数量 |
changeInOwnership | number | 0.0286 | 持股变动 |
changeInOwnershipPercentage | number | 0.3445 | 持股变动比例 |
holdingPeriod | number | 75 | 持有期 |
firstAdded | string | "2005-03-31" | 首次加入日期 |
performance | number | -29671950396 | 业绩表现 |
performancePercentage | number | -11.7338 | 业绩表现（%） |
lastPerformance | number | 38078179274 | 最近一期业绩表现 |
changeInPerformance | number | -67750129670 | 业绩变动 |
isCountedForPerformance | boolean | true | 是否计入业绩统计 |
查看响应数据示例（原始 JSON）
[
{
"date": "2023-09-30",
"cik": "0000102909",
"filingDate": "2023-12-18",
"investorName": "VANGUARD GROUP INC",
"symbol": "AAPL",
"securityName": "APPLE INC",
"typeOfSecurity": "COM",
"securityCusip": "037833100",
"sharesType": "SH",
"putCallShare": "Share",
"investmentDiscretion": "SOLE",
"industryTitle": "ELECTRONIC COMPUTERS",
"weight": 5.4673,
"lastWeight": 5.996,
"changeInWeight": -0.5287,
"changeInWeightPercentage": -8.8175,
"marketValue": 222572509140,
"lastMarketValue": 252876459509,
"changeInMarketValue": -30303950369,
"changeInMarketValuePercentage": -11.9837,
"sharesNumber": 1299997133,
"lastSharesNumber": 1303688506,
"changeInSharesNumber": -3691373,
"changeInSharesNumberPercentage": -0.2831,
"quarterEndPrice": 171.21,
"avgPricePaid": 20.65,内容已截断，完整字段以实际返回为准。
常见问题解答（FAQ）
2 个问题/stable/institutional-ownership/extract-analytics/holder 端点（持股机构申报分析）的参数设计与同模块的 机构持股人业绩汇总 有什么区别？
工程上常将两者配合：用 持股机构申报分析（/stable/institutional-ownership/extract-analytics/holder，必填 symbol, year, quarter）拉取 investorName 与 securityName 等 39 列，同时用 Holder Performance Summary（机构持股人业绩汇总）补充 33 列关联信息。
使用 /stable/institutional-ownership/extract-analytics/holder 采集持股机构申报分析构建因子库，推荐的请求切片方式是什么？
采集 /stable/institutional-ownership/extract-analytics/holder 的核心技巧是递增 page（配合 limit）翻页请求 /stable/institutional-ownership/extract-analytics/holder 直至返回 []；这能确保 持股机构申报分析 的 investorName 与 securityName 连续完整且无截断遗漏。
同模块相关接口对比
Holder本接口路径 /stable/institutional-ownership/extract-analytics/holder，必填参数 symbol、year、quarter。 同一模块「Holder」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。