Latest 8-K SEC Filings最新8-K申报文件
该接口提供上市公司最新 8-K 申报的实时数据:并购、收购、领导层变动等可能影响市场的重大事件,一经提交 SEC 即可获取。
https://quote-fmp.com/stable/sec-filings-8k?from=2024-01-01&to=2024-03-01&page=0&limit=100数据更新周期
1 Hour
接口说明
- 实时申报:8-K 申报文件一经提交 SEC 即可获取,重要公司动向不错过,传入
from后可读取formType(SEC申报表单类型(如10-K、10-Q、8-K、4、13F))、hasFinancials(是否含财务数据) 等标准记录,帮助开发团队快速搭建数据管道。 - 重大事件:追踪并购、收购、破产、领导层变动等重大公司事件,汇总
formType(SEC申报表单类型(如10-K、10-Q、8-K、4、13F))与hasFinancials(是否含财务数据) 等字段信息,方便输出标准化的个股或资产深度研究底稿。 - 申报原文直链:直接获取 SEC 申报文件原文,查看公司完整的披露细节,数据仓库建模时可将本接口与「最新SEC申报」归入同一主题域按周期同步。
- 上下游关联接口:SEC Filings Company Search By Symbol(股票代码检索公司) · SEC Filings Company Search By CIK(CIK 检索公司) · As Reported Income Statements(原始申报利润表) · Search Cik(CIK 检索)
请求参数
4 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
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 关键代码最新8-K申报文件路径为 /stable/sec-filings-8k(必填 from, to),响应 JSON 展开 formType(SEC 申报表单类型(如 10-K、10-Q、8-K、4、13F))、hasFinancials(是否含财务数据)、link(详情链接) 共 8 列。
resp = requests.get(
"https://quote-fmp.com/stable/sec-filings-8k",
params={"from": "2024-01-01", "to": "2024-03-01", "page": 0, "limit": 100, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 最新8-K申报文件 核心列:symbol, cik, filingDate, acceptedDate
df = df[["symbol", "cik", "filingDate", "acceptedDate"]].dropna(how="all")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 截取 2025Q1 日期窗口拉取最新8-K申报文件 | from=2025-01-01&to=2025-03-31 | 向 /stable/sec-filings-8k 传 from=2025-01-01&to=2025-03-31,提取该季度内的 formType、hasFinancials、link(样本 formType=8-K)。 |
| 按 2024 下半年滑窗回填最新8-K申报文件历史 | from=2024-07-01&to=2024-12-31 | 分段设置半年期 [from, to] 请求 /stable/sec-filings-8k,完整归档历史 formType、hasFinancials、link 等 8 列数据。 |
/stable/sec-filings-8k 返回 acceptedDate(样本 2024-03-01 22:47:48),但字段名不保证它在所有市场都是实际公开时刻。对经核实的 SEC 申报,可结合接收时间和时区判断可见性;非美标的、与期末同日的零点时间或回填日期,须先核对原始披露来源。未核实前保留原值,不据此承诺回测已消除前视偏差。
/stable/sec-filings-8k 的首条样本含 formType=8-K;日常同步任务按 (symbol, cik, filingDate) 合并即可保持本地库与上游一致。
返回数据
8 个字段本接口示例响应共包含 8 个字段(数值型 0 个,文本/日期/布尔型 8 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
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) |
hasFinancials | null | null | 是否含财务数据 |
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",
"hasFinancials": null,
"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 个问题最新8-K申报文件(/stable/sec-filings-8k)产出的 formType 等字段,与 最新SEC申报 的返回内容有何侧重?
最新8-K申报文件(端点 /stable/sec-filings-8k,必填 from, to)返回 formType(SEC 申报表单类型(如 10-K、10-Q、8-K、4、13F))及 hasFinancials(null)共 8 列;若业务需要 Latest SEC Filings(最新SEC申报),可改调 /stable/sec-filings-financials(必填 from, to)。
工程团队在封装 /stable/sec-filings-8k(最新8-K申报文件)客户端时,应采用怎样的拉取逻辑?
标准流程是用 from 与 to 按年度或季度分段请求 /stable/sec-filings-8k;在拿到 最新8-K申报文件 的 formType 与 hasFinancials 后,及时释放内存中的原始文本流。
同模块相关接口对比
Latest Filings本接口路径 /stable/sec-filings-8k,必填参数 from、to。 同一模块「Latest Filings」下共 2 个接口,下表列出其余 1 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 最新SEC申报Latest SEC Filings | /stable/sec-filings-financials | 实时返回上市公司最新提交的 SEC 申报文件 |