Positions Summary机构持仓汇总
该接口按股票代码与季度汇总全部 13F 申报机构的持仓全景，包含持股机构总数、机构合计持股数、持仓总市值、新增建仓/增持/减持/清仓机构家数及看涨看跌期权持仓比。
https://quote-fmp.com/stable/institutional-ownership/symbol-positions-summary?symbol=AAPL&year=2023&quarter=3数据更新周期
1 Hour
接口说明
- 跟踪机构投资趋势：监控机构投资者如何随时间调整某只股票的持仓，传入
symbol后可覆盖investorsHolding（持有该标的的机构数）、lastInvestorsHolding（最近持有该标的的机构数）与investorsHoldingChange（持有机构数变动） 等高频字段，适合定时批量归档至本地数据库。 - 持股洞察：了解机构投资者持有公司股份的比例及其变化，结合
lastInvestorsHolding（最近持有该标的的机构数）与investorsHoldingChange（持有机构数变动） 等明细维度，有助于对标的异动做归因拆解与交叉验证。 - 看涨看跌期权分析：洞察看跌/看涨期权比率，跟踪机构持仓的期权活动，研究端可将本接口与「细分行业表现汇总」组合编排，覆盖从概览快照到历史序列的需求。
- 配套投研接口：Institutional Ownership Filings（机构持股申报） · Filings Extract（SEC申报文件提取） · Search Cik（CIK 检索） · CUSIP（CUSIP 检索）
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 美国 SEC 监管申报或美股上市公司股票代码，例如 AAPL、MSFT、NVDA（仅覆盖美股及在美上市 ADR，无需附加交易所后缀）。 |
year | string | 必填 | 2023 | 目标财报/数据的年份，如 2023。 |
quarter | string | 必填 | 3 | 目标季度，1、2、3、4 分别对应 Q1~Q4。 |
调用代码示例
Python 关键代码示例向 /stable/institutional-ownership/symbol-positions-summary 发起机构持仓汇总请求（必填 symbol, year, quarter），并清洗 investorsHolding（持有该标的的机构数）、lastInvestorsHolding（最近持有该标的的机构数）、investorsHoldingChange（持有机构数变动） 等核心列。
resp = requests.get(
"https://quote-fmp.com/stable/institutional-ownership/symbol-positions-summary",
params={"symbol": "AAPL", "year": "2023", "quarter": "3", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 investorsHolding（持有该标的的机构数）
df["investorsHolding"] = pd.to_numeric(df["investorsHolding"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按代码 AAPL 提取机构持仓汇总截面 | symbol=AAPL&year=2023&quarter=3 | 对 /stable/institutional-ownership/symbol-positions-summary 传入必填项 AAPL，读取 investorsHolding、lastInvestorsHolding、investorsHoldingChange（investorsHolding=4863）共 36 个字段。 |
| 切换美股龙头 NVDA 对比机构持仓汇总 | symbol=NVDA&year=2023&quarter=3 | 改用 symbol=NVDA 调用 /stable/institutional-ownership/symbol-positions-summary，提取 NVDA 的 investorsHolding、lastInvestorsHolding、investorsHoldingChange 与 AAPL 横向对标。 |
/stable/institutional-ownership/symbol-positions-summary 返回的机构持仓汇总数据集（必填 symbol, year, quarter）以 investorsHolding（样本 4863）和 lastInvestorsHolding（样本 4805）为核心，衍生计算前建议先做缺失值检测。
同步 /stable/institutional-ownership/symbol-positions-summary 的 36 个字段入库时，依赖 (symbol, cik, date) 实现幂等去重；核心数值 investorsHolding（如 4863）可直接用于量化回测计算。
返回数据
36 个字段本接口示例响应共包含 36 个字段（数值型 33 个，文本/日期/布尔型 3 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
cik | string | "0000320193" | SEC CIK 编号（SEC 10 位定长中央索引键，落库须定义为 VARCHAR(10) 字符串以防前导零丢失） |
date | string | "2023-09-30" | 日期 |
investorsHolding | number | 4863 | 持有该标的的机构数 |
lastInvestorsHolding | number | 4805 | 最近持有该标的的机构数 |
investorsHoldingChange | number | 58 | 持有机构数变动 |
numberOf13Fshares | number | 9139920744 | 13F 申报持股数量 |
lastNumberOf13Fshares | number | 9360939709 | 最近一次 13F 申报持股数量 |
numberOf13FsharesChange | number | -221018965 | 13F 申报持股数量变动 |
totalInvested | number | 1575774922899 | 投资总额 |
lastTotalInvested | number | 1820827010085 | 最近投资总额 |
totalInvestedChange | number | -245052087186 | 投资总额变动 |
ownershipPercent | number | 58.5914 | 持股比例 |
lastOwnershipPercent | number | 59.6329 | 最近持股比例 |
ownershipPercentChange | number | -1.0415 | 持股比例变动 |
newPositions | number | 162 | 新建仓数量 |
lastNewPositions | number | 191 | 最近新建仓数量 |
newPositionsChange | number | -29 | 新建仓数量变动 |
increasedPositions | number | 1941 | 加仓数量 |
lastIncreasedPositions | number | 1789 | 最近加仓数量 |
increasedPositionsChange | number | 152 | 加仓数量变动 |
closedPositions | number | 158 | 已清仓头寸 |
lastClosedPositions | number | 122 | 最近已清仓头寸 |
closedPositionsChange | number | 36 | 清仓头寸变动 |
reducedPositions | number | 2408 | 减仓数量 |
lastReducedPositions | number | 2543 | 最近减仓数量 |
reducedPositionsChange | number | -135 | 减仓数量变动 |
totalCalls | number | 173627138 | 看涨期权数 |
lastTotalCalls | number | 198895582 | 最近看涨期权数 |
totalCallsChange | number | -25268444 | 看涨期权数变动 |
totalPuts | number | 192913290 | 看跌期权数 |
lastTotalPuts | number | 177042062 | 最近看跌期权数 |
totalPutsChange | number | 15871228 | 看跌期权数变动 |
putCallRatio | number | 1.1111 | 看跌看涨比率 |
lastPutCallRatio | number | 0.8901 | 最近看跌看涨比率 |
putCallRatioChange | number | 22.0952 | 看跌看涨比率变动 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "AAPL",
"cik": "0000320193",
"date": "2023-09-30",
"investorsHolding": 4863,
"lastInvestorsHolding": 4805,
"investorsHoldingChange": 58,
"numberOf13Fshares": 9139920744,
"lastNumberOf13Fshares": 9360939709,
"numberOf13FsharesChange": -221018965,
"totalInvested": 1575774922899,
"lastTotalInvested": 1820827010085,
"totalInvestedChange": -245052087186,
"ownershipPercent": 58.5914,
"lastOwnershipPercent": 59.6329,
"ownershipPercentChange": -1.0415,
"newPositions": 162,
"lastNewPositions": 191,
"newPositionsChange": -29,
"increasedPositions": 1941,
"lastIncreasedPositions": 1789,
"increasedPositionsChange": 152,
"closedPositions": 158,
"lastClosedPositions": 122,
"closedPositionsChange": 36,
"reducedPositions": 2408,
"lastReducedPositions": 2543,内容已截断，完整字段以实际返回为准。
常见问题解答（FAQ）
2 个问题机构持仓汇总（/stable/institutional-ownership/symbol-positions-summary）相比同模块的 细分行业表现汇总，在查询维度与字段上差在哪？
机构持仓汇总 走 /stable/institutional-ownership/symbol-positions-summary 端点（必填 symbol, year, quarter），单条含 investorsHolding、lastInvestorsHolding、investorsHoldingChange 共 36 项字段；同模块的 Industry Performance Summary（细分行业表现汇总） 走 /stable/institutional-ownership/industry-summary（必填 year, quarter，3 项字段）。
针对 /stable/institutional-ownership/symbol-positions-summary（机构持仓汇总），工程脚本中如何避免漏数或无效轮询？
生产调度中通常在 /stable/institutional-ownership/symbol-positions-summary 中指定 symbol（跨市场代码须保留后缀）；每次拉回 investorsHolding（样本 4863）后，按时间或代码水位线增量推进。
同模块相关接口对比
Symbol本接口路径 /stable/institutional-ownership/symbol-positions-summary，必填参数 symbol、year、quarter。 同一模块「Symbol」下共 2 个接口，下表列出其余 1 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 细分行业表现汇总Industry Performance Summary | /stable/institutional-ownership/industry-summary | 按特定时期汇总各行业的整体表现，帮助识别强势与弱势板块、比较行业间的财务健康度 |