免费 10-K API获取 SEC 年报数据

免费 10-K API：开发者真正要完成的任务

直接答案是：SEC EDGAR 免费提供权威的 10-K 元数据、申报正文、附件和标签化事实，但它并不是开箱即用的年报分析 API。接入方仍需解析发行人、选择正确文件版本、下载所需文档层、处理叙述章节或 XBRL 上下文，并保留足够证据，使每个结果都能复现。

应从研究问题反推输出。申报监控需要 accession number 与受理时间；风险模型需要 Item 1A 正文及章节边界；财务模型需要带期间上下文的 facts 或标准化报表；审计流程则可能需要完整文件索引和附件。把这些统称为“10-K 数据”，会掩盖完整性与验证方式上的关键差异。

如何评估免费的 SEC 年报 API

SEC 10-K 数据接口的申报、JSON 与 XBRL 输出

SEC EDGAR 数据 API以 JSON 提供公司 submissions 与已提取的 XBRL 数据。submissions 可定位近期 10-K 与 10-K/A，company facts 可返回带标签的财务事实；二者都不等同于已经统一口径的利润表、资产负债表或现金流量表接口。

对于文档分析，主要 10-K HTML 只是整套申报材料的一部分。文件索引还可能列出附件、XBRL 实例与分类文件、管理层认证，以及通过引用纳入的其他文件。应用必须明确承诺的是“主要年报正文”还是“完整申报材料”，因为两者对应不同的完整性标准。

10-K、年度报告与 10-K/A 的区别

Form 10-K 是提交给 SEC 的年度申报；面向股东的设计版年度报告可能是另一份文档。10-K/A 应作为修订文件处理，需保留原始与修订 accession，不能静默覆盖。

修订文件还需要语义层面的判断。10-K/A 可能只修改有限披露，并不会重新提交全部章节；代理声明也可能补充通过引用纳入的内容。应保存版本链、识别哪些 Item 发生变化，不能把单独的修订文件当作完整重述年报展示。

使用 Python 接入免费 10-K API

步骤 1：把股票代码映射为 CIK

先把股票代码映射到 SEC CIK，并补足为 10 位用于 company submissions 请求。两种标识都应保存，因为 ticker 可能变化，而 CIK 是 SEC 的稳定实体键。可通过 SEC 的开发者资源核对可用数据与访问要求。

同时记录映射来源与观察日期。如果同一发行人有多个上市股份类别，还要区分用户选择的是证券还是申报主体；EDGAR 的文件查询最终以主体 CIK 为准。

步骤 2：筛选 10-K 与 10-K/A

获取 submissions JSON，将 recent filings 中的并行数组组合为记录，再按精确表单值筛选。保留 form、filing date、accession number、primary document 与 report date。

不要假设 recent 数组覆盖全部历史。如果目标年份不在其中，应继续读取引用的较早 submissions 文件。“当时已知的最新文件”应按 accepted timestamp 排序，10-K/A 则进入相关但独立的版本流。

步骤 3：下载或解析所需数据层

需要全文时，用 accession 与 primary document 构造 SEC 存档链接；需要标签值时使用 XBRL company facts；需要统一口径财务报表时，再选择文档明确的第三方 10-K 数据接口。

解析前先缓存不可变的原始正文与文件索引，并遵循 SEC 的自动访问规范。提取章节时要谨慎去除导航和目录噪声，保留具有信息意义的表格，并记录解析器版本与来源位置。财务 facts 应保留 concept、单位、期间、维度、表格、申报日与 accession number，不能只按标签名称选取数值。

import requests

headers = {"User-Agent": "YourApp contact@example.com"}
cik = "0000320193"
data = requests.get(
    f"https://data.sec.gov/submissions/CIK{cik}.json",
    headers=headers,
    timeout=30,
).json()

recent = data["filings"]["recent"]
records = [dict(zip(recent, row)) for row in zip(*recent.values())]
annual = [r for r in records if r["form"] in {"10-K", "10-K/A"}]

使用 QVeris 发现 10-K 数据能力

准备接入所选能力时，请按照 QVeris 工具调用手册配置准确的 tool ID、请求参数与响应结构，并在后续研究输出中保留 SEC 原始链接。

免费 10-K API 常见问题