Institutional Ownership Filings机构持股申报
该接口是全市场 SEC Form 13F 机构持仓报告的实时广播流。它按监管接收时间倒序推送最新提交或更正持仓报告的资管机构名单，用于第一时间发现华尔街大型对冲基金与养老基金的最新披露动向。
https://quote-fmp.com/stable/institutional-ownership/latest?page=0&limit=100数据更新周期
1-2 Hours
接口说明
- 全市场 13F 披露实时雷达：按美国证监会要求，管理美股权益资产超 1 亿美元的机构须在每个自然季度结束后的 45 天内披露持仓。该接口以时间流形式汇总全市场最新落地的 13F 正式报告与更正报告，解决“成千上万家基金不知道谁刚交了表”的监控难题。
- 持仓提取流水线入口：在工程架构上，该接口扮演上游调度触发器角色——通过定时轮询比对最新披露时间戳，一旦捕获目标对冲基金或知名机构交表，即可提取其机构编码与报告期，触发下游接口拉取具体的重仓股增减持明细。
- 保密仓位与申报溯源：除常规季度持仓报告外，流水中同步包含机构因保密豁免到期而补发的更正申报（13F-HR/A），并提供直达 SEC EDGAR 原始 XML 申报文件的官方链接，满足深度投研复核与合规留档需求。
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
page | number | 可选 | 0 | 分页页码，从 0 开始，配合每页条数翻页取更多数据（从 0 起算的分页游标；当响应返回空数组 [] 时代表已翻至历史末页） |
limit | number | 可选 | 100 | 返回结果条数上限，用于控制单次响应大小。 |
调用代码示例
Python 关键代码本接口返回全市场最新 13F 申报流水；拿到刚交表的机构 cik、year、quarter 后，传入 /stable/institutional-ownership/extract 即可拉取其逐只股票持仓明细。
resp = requests.get(
"https://quote-fmp.com/stable/institutional-ownership/latest",
params={"page": 0, "limit": 100, "apikey": FMP_KEY},
)
df = pd.DataFrame(resp.json())
# 强制保留 10 位前导零 CIK，并拆出报告期 (year, quarter) 传给下游 filings-extract
df["cik"] = df["cik"].astype(str).str.zfill(10)
dt = pd.to_datetime(df["date"])
df["year"], df["quarter"] = dt.dt.year, dt.dt.quarter参数使用和避坑
2 组参数组合 · 3 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 轮询全市场最新提交的 13F 机构名单（首页） | page=0&limit=100 | 按 SEC 接收时间倒序返回最近刚提交 13F-HR 或 13F-HR/A 的前 100 家机构、CIK、报告期 date 与精确披露时间 acceptedDate。 |
| 在季度披露截止日高峰期翻页全量扫描 | page=1&limit=100 | 绝大多数对冲基金会在季末后第 40～45 天压线提交 13F，通过递增 page=0,1,2... 并比对本地 acceptedDate 水位线可完整捕获新增申报。 |
按 SEC 规定，管理规模超 1 亿美元的机构可在每个自然季度结束后的 45 天内提交 13F（例如 Q2 持仓报告期末日 date 为 2026-06-30，而实际披露时间 acceptedDate 多集中在 7 月底至 8 月中旬）。构建「聪明钱跟单策略」时，必须以 acceptedDate 作为信号可见时点，切勿在 06-30 当天调仓（完整代码见 13F 机构持仓与内部人交易实战）。
SEC Form 13F 仅强制披露美股多头股票（Long Equity）、看涨/看跌期权多头（Call / Put）与可转债，不披露直接融券卖空（Short Selling）仓位。因此某家多空对冲基金的多头持仓可能只是其空头部位的对冲腿，分析时建议结合 Positions Summary（机构持仓汇总）与 Latest Insider Trading（最新内部人交易）交叉印证。
当巴菲特（伯克希尔 0001067983）等巨型机构正在建仓某只股票且向 SEC 申请保密豁免时，当季首次 13F-HR 会隐去该标的；待后续豁免到期，机构会提交 formType="13F-HR/A" 补齐持仓。监控流水中出现的知名机构 13F-HR/A 往往隐含建仓完毕的底牌信息。
返回数据
8 个字段本接口示例响应共包含 8 个字段（数值型 0 个，文本/日期/布尔型 8 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
cik | string | "0001803005" | SEC CIK 编号（SEC 10 位定长中央索引键，落库须定义为 VARCHAR(10) 字符串以防前导零丢失） |
name | string | "WEALTH ADVISORS OF IOWA, LLC" | 名称 |
date | string | "2026-06-30" | 日期 |
filingDate | string | "2026-07-30 00:00:00" | 申报日期（监管申报日期；若同表含 acceptedDate，实盘事件对齐应优先取 acceptedDate） |
acceptedDate | string | "2026-07-30 13:14:23" | 受理日期（SEC 精确到秒接收时间戳；Point-in-Time 量化回测须以此时间为准以防未来函数） |
formType | string | "13F-HR" | SEC 申报表单类型（如 10-K、10-Q、8-K、4、13F） |
link | string | "https://www.sec.gov/Archives/e…" | 详情链接 |
finalLink | string | "https://www.sec.gov/Archives/e…" | 申报文件最终链接 |
查看响应数据示例（原始 JSON）
[
{
"cik": "0001803005",
"name": "WEALTH ADVISORS OF IOWA, LLC",
"date": "2026-06-30",
"filingDate": "2026-07-30 00:00:00",
"acceptedDate": "2026-07-30 13:14:23",
"formType": "13F-HR",
"link": "https://www.sec.gov/Archives/edgar/data/1803005/000180300526000003/0001803005-26-000003-index.htm",
"finalLink": "https://www.sec.gov/Archives/edgar/data/1803005/000180300526000003/xslForm13F_X02/primary_doc.xml"
}
]常见问题解答（FAQ）
3 个问题为什么本接口传入 symbol=AAPL 或 cik=0001067983 没有任何过滤效果？
因为本接口（/stable/institutional-ownership/latest）是全市场最新申报广播流，仅接受 page 和 limit 分页参数。如果你想查某家特定机构（如伯克希尔）的持仓明细，请调用 Filings Extract（SEC申报文件提取，/apis/filings-extract/）；如果想查某只特定股票（如 AAPL）被哪些机构持有，请调用 Filings Extract With Analytics By Holder（持股机构申报分析，/apis/filings-extract-with-analytics-by-holder/）或 Positions Summary（机构持仓汇总，/apis/positions-summary/）。
link 和 finalLink 两个 SEC 链接字段有什么区别？
link 指向该次申报在 SEC EDGAR 上的 Filing Index 索引目录页（HTML），而 finalLink 直接指向承载具体持仓表格的底层 XML/HTML 主文件（如 primary_doc.xml）。做原始文件留档或二次校验时直接抓取 finalLink 即可。
如何把机构名称（如 Berkshire Hathaway）转换成 10 位 CIK 编码？
可以调用检索类别下的 Search Cik（CIK 检索，/apis/search-cik/）接口，传入机构英文名称关键词即可返回对应的 10 位标准 CIK 编码。
同模块相关接口对比
Extract本接口路径 /stable/institutional-ownership/latest，无必填参数。 同一模块「Extract」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。