SEC Filings By Form Type按表格类型查 SEC 申报
该接口按监管表单类型（如 10-K 年报、10-Q 季报、8-K 重大事件、Form 4 内部人交易）与日期区间批量检索全市场 SEC EDGAR 申报文件及原文链接。
https://quote-fmp.com/stable/sec-filings-search/form-type?formType=8-K&from=2024-01-01&to=2024-03-01&page=0&limit=100数据更新周期
N/A · 不适用固定周期
接口说明
- 定向申报检索：按表格类型检索 SEC 申报,获取 8-K、10-K、10-Q 等特定报告，传入
formType后可解析出symbol（证券代码）、cik（SECCIK编号）与filingDate（申报日期） 等字段，适合作为回测框架的基础数据层。 - 文档直达链接：直接从 SEC 获取完整申报及相关附件，完整掌握公司披露内容，围绕
cik（SECCIK编号）与filingDate（申报日期） 等字段，可在回测中还原历史任意时点的真实截面。 - 监管合规监控：监控合规事件、并购、财务披露与治理更新相关的申报，买方团队在构建跟踪看板时，可并联接入「按名称查 SEC 申报」以增强监控颗粒度。
- 上下游关联接口：SEC Company Full Profile（SEC 公司完整档案） · Industry Classification List（行业分类清单） · Search Cik（CIK 检索） · Latest Insider Trading（最新内部人交易）
请求参数
5 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
formType | string | 必填 | 8-K | SEC 申报文件类型，如 10-K、10-Q、8-K、4、13F。 |
from | string | 必填 | 2024-01-01 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | string | 必填 | 2024-03-01 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
page | number | 可选 | 0 | 分页页码，从 0 开始，配合每页条数翻页取更多数据（从 0 起算的分页游标；当响应返回空数组 [] 时代表已翻至历史末页） |
limit | number | 可选 | 100 | 返回结果条数上限，用于控制单次响应大小。 |
调用代码示例
Python 关键代码从 /stable/sec-filings-search/form-type 同步按表格类型查 SEC 申报（必填 formType, from, to），一次拿齐 formType（SEC 申报表单类型（如 10-K、10-Q、8-K、4、13F））、link（详情链接）、finalLink（申报文件最终链接）（样本值 formType=8-K）。
resp = requests.get(
"https://quote-fmp.com/stable/sec-filings-search/form-type",
params={"formType": "8-K", "from": "2024-01-01", "to": "2024-03-01", "page": 0, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 按表格类型查 SEC 申报 核心列：symbol, cik, filingDate, acceptedDate
df = df[["symbol", "cik", "filingDate", "acceptedDate"]].dropna(how="all")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按季度日历边界检索 2025Q1 按表格类型查 SEC 申报 | formType=8-K&from=2025-01-01&to=2025-03-31 | 以闭区间 [2025-01-01, 2025-03-31] 查询 /stable/sec-filings-search/form-type，精准过滤出当季的 formType、link、finalLink 明细。 |
| 指定 2024 年末半年窗口同步按表格类型查 SEC 申报 | formType=8-K&from=2024-07-01&to=2024-12-31 | 切换至 2024 年下半年区间查询 /stable/sec-filings-search/form-type，与当期数据拼接成连续的 formType、link、finalLink 时间序列。 |
/stable/sec-filings-search/form-type 返回 acceptedDate（样本 2024-03-01 22:47:48），但字段名不保证它在所有市场都是实际公开时刻。对经核实的 SEC 申报，可结合接收时间和时区判断可见性；非美标的、与期末同日的零点时间或回填日期，须先核对原始披露来源。未核实前保留原值，不据此承诺回测已消除前视偏差。
持久化 /stable/sec-filings-search/form-type（按表格类型查 SEC 申报）的 7 个字段时，自然键取 (symbol, cik, filingDate)；标识列 formType（样本 8-K）请保持大小写与上游一致。
返回数据
7 个字段本接口示例响应共包含 7 个字段（数值型 0 个，文本/日期/布尔型 7 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "SUNE" | 证券代码 |
cik | string | "0000022701" | SEC CIK 编号（SEC 10 位定长中央索引键，落库须定义为 VARCHAR(10) 字符串以防前导零丢失） |
filingDate | string | "2024-03-04 00:00:00" | 申报日期（监管申报日期；若同表含 acceptedDate，实盘事件对齐应优先取 acceptedDate） |
acceptedDate | string | "2024-03-01 22:47:48" | 受理日期（SEC 精确到秒接收时间戳；Point-in-Time 量化回测须以此时间为准以防未来函数） |
formType | string | "8-K" | 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）
[
{
"symbol": "SUNE",
"cik": "0000022701",
"filingDate": "2024-03-04 00:00:00",
"acceptedDate": "2024-03-01 22:47:48",
"formType": "8-K",
"link": "https://www.sec.gov/Archives/edgar/data/22701/000089710124000091/0000897101-24-000091-index.htm",
"finalLink": "https://www.sec.gov/Archives/edgar/data/22701/000089710124000091/pegy240248_8k.htm"
}
]常见问题解答（FAQ）
2 个问题在「Search Filings」下，按表格类型查 SEC 申报（/stable/sec-filings-search/form-type）与 按代码查 SEC 申报（/stable/sec-filings-search/symbol）如何分工？
按表格类型查 SEC 申报（/stable/sec-filings-search/form-type，必填 formType, from, to）重在输出 formType（SEC 申报表单类型（如 10-K、10-Q、8-K、4、13F））与 link 等 7 列；而 SEC Filings By Symbol（按代码查 SEC 申报）返回 7 列，两者按查询维度互补。
在批量同步按表格类型查 SEC 申报时，/stable/sec-filings-search/form-type 的查询窗口与参数组合该如何安排？
推荐做法：在 /stable/sec-filings-search/form-type 中传入 from/to 日期区间分批拉取；当 /stable/sec-filings-search/form-type 正常返回含 formType 的 JSON/CSV 后，即可直接合入本地策略宽表。
同模块相关接口对比
Search Filings本接口路径 /stable/sec-filings-search/form-type，必填参数 formType、from、to。 同一模块「Search Filings」下共 4 个接口，下表列出其余 3 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 按代码查 SEC 申报SEC Filings By Symbol | /stable/sec-filings-search/symbol | 按股票代码与起止日期区间查询指定上市公司的全部美国证监会（SEC）监管申报记录 |
| 按 CIK 查 SEC 申报SEC Filings By CIK | /stable/sec-filings-search/cik | 按 SEC 10 位 CIK 编号查询指定主体提交的历史监管申报文件清单 |
| 按名称查 SEC 申报SEC Filings By Name | /stable/sec-filings-company-search/name | 按公司名称或申报实体英文关键词模糊检索 SEC EDGAR 申报记录 |