SEC Filings By CIK按 CIK 查 SEC 申报
该接口按 SEC 10 位 CIK 编号查询指定主体提交的历史监管申报文件清单,兼容尚未在二级市场挂牌或已退市的申报主体。
https://quote-fmp.com/stable/sec-filings-search/cik?cik=0000320193&from=2024-01-01&to=2024-03-01&page=0&limit=100数据更新周期
N/A · 不适用固定周期
接口说明
- 按实体查申报:检索与特定 CIK 编号关联的 SEC 申报,CIK 唯一标识上市公司、公募基金及其他注册主体。
- 实时申报:接收该实体最新 SEC 提交的更新,包括 8-K、10-K、10-Q 等表格,利用
cik(SECCIK编号)与filingDate(申报日期) 等标准字段,可直接计算衍生比率或滚动窗口统计量。 - 申报直达链接:直接打开 SEC 官方申报及相关文件或附件,若需补充上下文维度,可搭配同模块的「按代码查 SEC 申报」交叉比对核心指标。
- 关联数据线接口:Latest SEC Filings(最新SEC申报) · SEC Filings Company Search By Symbol(股票代码检索公司) · Financial Reports Form 10-K JSON(10-K年报数据(JSON)) · As Reported Income Statements(原始申报利润表)
请求参数
5 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
cik | string | 必填 | 0000320193 | SEC Central Index Key(CIK)编号,用于定位公司 SEC 主体(须传补足前导零的 10 位定长字符串,如 "0000320193",切勿传整型) |
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 关键代码请求 按 CIK 查 SEC 申报(/stable/sec-filings-search/cik,必填 cik, from, to),解析后可得 formType(SEC 申报表单类型(如 10-K、10-Q、8-K、4、13F))、link(详情链接)、finalLink(申报文件最终链接) 共 7 项数据。
resp = requests.get(
"https://quote-fmp.com/stable/sec-filings-search/cik",
params={"cik": "0000320193", "from": "2024-01-01", "to": "2024-03-01", "page": 0, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 按 CIK 查 SEC 申报 核心列:symbol, cik, filingDate, acceptedDate
df = df[["symbol", "cik", "filingDate", "acceptedDate"]].dropna(how="all")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按 10 位 CIK(0000320193)检索按 CIK 查 SEC 申报 | cik=0000320193&from=2024-01-01&to=2024-03-01 | 向 /stable/sec-filings-search/cik 传补零 10 位 cik=0000320193,获取 formType、link、finalLink(样本 formType=4)。 |
| 切换代表性机构/主体(cik=0001067983)对比按 CIK 查 SEC 申报 | cik=0001067983&from=2024-01-01&to=2024-03-01 | 改传 cik=0001067983 调用 /stable/sec-filings-search/cik,横向比较不同 SEC 申报主体的 formType、link、finalLink。 |
/stable/sec-filings-search/cik 返回 acceptedDate(样本 2024-03-01 18:36:45),但字段名不保证它在所有市场都是实际公开时刻。对经核实的 SEC 申报,可结合接收时间和时区判断可见性;非美标的、与期末同日的零点时间或回填日期,须先核对原始披露来源。未核实前保留原值,不据此承诺回测已消除前视偏差。
按 CIK 查 SEC 申报(/stable/sec-filings-search/cik)全部 7 列均为文本或日期属性,按 (symbol, cik, filingDate) 建主键并将 formType(SEC 申报表单类型(如 10-K、10-Q、8-K、4、13F))设为 TEXT 类型最为稳妥。
返回数据
7 个字段本接口示例响应共包含 7 个字段(数值型 0 个,文本/日期/布尔型 7 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
cik | string | "0000320193" | SEC CIK 编号(SEC 10 位定长中央索引键,落库须定义为 VARCHAR(10) 字符串以防前导零丢失) |
filingDate | string | "2024-03-01 00:00:00" | 申报日期(监管申报日期;若同表含 acceptedDate,实盘事件对齐应优先取 acceptedDate) |
acceptedDate | string | "2024-03-01 18:36:45" | 受理日期(SEC 精确到秒接收时间戳;Point-in-Time 量化回测须以此时间为准以防未来函数) |
formType | string | "4" | 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": "AAPL",
"cik": "0000320193",
"filingDate": "2024-03-01 00:00:00",
"acceptedDate": "2024-03-01 18:36:45",
"formType": "4",
"link": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000039/0000320193-24-000039-index.htm",
"finalLink": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000039/xslF345X05/wk-form4_1709336196.xml"
}
]常见问题解答(FAQ)
2 个问题按 CIK 查 SEC 申报(共 7 列)与 按表格类型查 SEC 申报(共 7 列)在工程调用中怎么配合?
在参数上,按 CIK 查 SEC 申报(/stable/sec-filings-search/cik)为必填 cik, from, to,输出 formType(4)等 7 列;SEC Filings By Form Type(按表格类型查 SEC 申报)为必填 formType, from, to,输出 7 列,可按需串联调用。
在多资产或长周期策略中使用按 CIK 查 SEC 申报(/stable/sec-filings-search/cik),请求参数该如何编排?
调用 /stable/sec-filings-search/cik 时宜指定起止日期 from/to 分段同步 /stable/sec-filings-search/cik;冷启动全量回填可分批执行,日常盘后则只拉最新一期 formType(SEC 申报表单类型(如 10-K、10-Q、8-K、4、13F))。
同模块相关接口对比
Search Filings本接口路径 /stable/sec-filings-search/cik,必填参数 cik、from、to。 同一模块「Search Filings」下共 4 个接口,下表列出其余 3 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 按表格类型查 SEC 申报SEC Filings By Form Type | /stable/sec-filings-search/form-type | 按监管表单类型与日期区间批量检索全市场 SEC EDGAR 申报文件及原文链接 |
| 按代码查 SEC 申报SEC Filings By Symbol | /stable/sec-filings-search/symbol | 按股票代码与起止日期区间查询指定上市公司的全部美国证监会(SEC)监管申报记录 |
| 按名称查 SEC 申报SEC Filings By Name | /stable/sec-filings-company-search/name | 按公司名称或申报实体英文关键词模糊检索 SEC EDGAR 申报记录 |