Filings ExtractSEC申报文件提取
该接口直接从官方 SEC 申报文件中提取结构化数据，包括持股数量、市值、证券细节和申报链接，便于分析公司披露信息，可直接用于机构重仓股穿透、聪明钱调仓方向追踪与机构抱团集中度分析。
https://quote-fmp.com/stable/institutional-ownership/extract?cik=0001388838&year=2023&quarter=3数据更新周期
1-2 Hours
接口说明
- SEC 申报文件分析：从 SEC 申报文件中提取持股数量、市值、证券细节等关键信息，传入
cik后可获取securityCusip（证券CUSIP代码）、nameOfIssuer（发行人名）与shares（持股数量） 等核心要素，减少跨市场数据入库时的字段映射工作。 - 股权变动跟踪：通过申报报告持续监控公司股权结构随时间的变化，配合
nameOfIssuer（发行人名）与shares（持股数量） 等返回项，能高效支撑同行业标的横向比对。 - 申报文件对比：比较不同申报期的详细数据，跟踪趋势与变化，买方团队在构建跟踪看板时，可并联接入「13F申报日期查询」以增强监控颗粒度。
- 关联数据线接口：Holders Industry Breakdown（机构持股行业分布） · Positions Summary（机构持仓汇总） · Company Profile Data（公司概况） · SEC Filings By CIK（按 CIK 查 SEC 申报）
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
cik | string | 必填 | 0001388838 | 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/extract 查询SEC申报文件提取（必填 cik, year, quarter），直接产出 securityCusip（证券 CUSIP 代码）、nameOfIssuer（发行人名）、shares（持股数量） 等 14 项字段。
resp = requests.get(
"https://quote-fmp.com/stable/institutional-ownership/extract",
params={"cik": "0001388838", "year": "2023", "quarter": "3", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 保留上游 acceptedDate 并清洗 securityCusip；可见时间须另核对披露来源和时区
df["reported_accepted_time"] = pd.to_datetime(df["acceptedDate"], errors="coerce")
df["securityCusip"] = pd.to_numeric(df["securityCusip"], errors="coerce")参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按 10 位 CIK（0001388838）检索SEC申报文件提取 | cik=0001388838&year=2023&quarter=3 | 向 /stable/institutional-ownership/extract 传补零 10 位 cik=0001388838，获取 securityCusip、nameOfIssuer、shares（样本 securityCusip=674215207）。 |
| 切换代表性机构/主体（cik=0001067983）对比SEC申报文件提取 | cik=0001067983&year=2023&quarter=3 | 改传 cik=0001067983 调用 /stable/institutional-ownership/extract，横向比较不同 SEC 申报主体的 securityCusip、nameOfIssuer、shares。 |
| 回溯 2024Q4 历史季末SEC申报文件提取截面 | cik=0001388838&year=2024&quarter=Q4 | 指定 year=2024&quarter=Q4，还原 0001388838 在历史季末的 securityCusip、nameOfIssuer、shares 明细。 |
/stable/institutional-ownership/extract 返回 acceptedDate（样本 2023-11-13），但字段名不保证它在所有市场都是实际公开时刻。对经核实的 SEC 申报，可结合接收时间和时区判断可见性；非美标的、与期末同日的零点时间或回填日期，须先核对原始披露来源。未核实前保留原值，不据此承诺回测已消除前视偏差。
在为SEC申报文件提取（/stable/institutional-ownership/extract）设计表结构时，以 (symbol, cik, date) 唯一锁定记录，并对 securityCusip（证券 CUSIP 代码）与 shares（持股数量） 保留完整浮点精度。
返回数据
14 个字段本接口示例响应共包含 14 个字段（数值型 2 个，文本/日期/布尔型 12 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
date | string | "2023-09-30" | 日期 |
filingDate | string | "2023-11-13" | 申报日期（监管申报日期；若同表含 acceptedDate，实盘事件对齐应优先取 acceptedDate） |
acceptedDate | string | "2023-11-13" | 受理日期（SEC 精确到秒接收时间戳；Point-in-Time 量化回测须以此时间为准以防未来函数） |
cik | string | "0001388838" | SEC CIK 编号（SEC 10 位定长中央索引键，落库须定义为 VARCHAR(10) 字符串以防前导零丢失） |
securityCusip | string | "674215207" | 证券 CUSIP 代码 |
symbol | string | "CHRD" | 证券代码 |
nameOfIssuer | string | "CHORD ENERGY CORPORATION" | 发行人名 |
shares | number | 13280 | 持股数量 |
titleOfClass | string | "COM NEW" | 证券类别名称 |
sharesType | string | "SH" | 股份类型代码（如 SH） |
putCallShare | string | "" | 看跌看涨占比 |
value | number | 2152290 | 数值 |
link | string | "https://www.sec.gov/Archives/e…" | 详情链接 |
finalLink | string | "https://www.sec.gov/Archives/e…" | 申报文件最终链接 |
查看响应数据示例（原始 JSON）
[
{
"date": "2023-09-30",
"filingDate": "2023-11-13",
"acceptedDate": "2023-11-13",
"cik": "0001388838",
"securityCusip": "674215207",
"symbol": "CHRD",
"nameOfIssuer": "CHORD ENERGY CORPORATION",
"shares": 13280,
"titleOfClass": "COM NEW",
"sharesType": "SH",
"putCallShare": "",
"value": 2152290,
"link": "https://www.sec.gov/Archives/edgar/data/1388838/000117266123003760/0001172661-23-003760-index.htm",
"finalLink": "https://www.sec.gov/Archives/edgar/data/1388838/000117266123003760/infotable.xml"
}
]常见问题解答（FAQ）
2 个问题在「Extract」分类下，SEC申报文件提取（14 个字段）与 机构持股申报 的核心差异点是什么？
SEC申报文件提取 与 Institutional Ownership Filings（机构持股申报） 分别映射 /stable/institutional-ownership/extract（必填 cik, year, quarter，含 securityCusip 等 14 列）与 /stable/institutional-ownership/latest（无必填参数，含 8 列），可按研究粒度灵活选用。
实盘任务调用 /stable/institutional-ownership/extract 拉取SEC申报文件提取时，如何规范化控制查询边界与重试节奏？
您只需按 cik 过滤条件请求 /stable/institutional-ownership/extract 并做非空校验；配合空数组 [] 短路判断，即可构建零人工干预的 SEC申报文件提取（securityCusip）自动化同步任务。
同模块相关接口对比
Extract本接口路径 /stable/institutional-ownership/extract，必填参数 cik、year、quarter。 同一模块「Extract」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。