SEC 申报数据方法论

官方来源

来源是美国证券交易委员会。Narwhal 使用公司关联、提交元数据和 EDGAR 申报索引。

响应会链接到 SEC 申报索引和主要文档页面。不包含申报正文和附件。

公司身份

• 一个不透明的 Narwhal company_id 是永久路由身份。
• CIK、股票代码、交易所、当前名称、曾用名、实体类型和 SIC 都是来源属性或别名。
• 股票代码可能变更或复用，因此永远不会成为永久的资源标识。
• 来源中的可空字段保持为 null。Narwhal 不会推断缺失的上市状态、行业或实体分类。

申报文件标识与修订件

• 申报编号是全球申报身份标识。
• 一份申报编号可能关联多家公司；Narwhal 只存储一次申报文件，并保留明确的公司关系。
• 表格、申报日期、UTC 接受时间、可为空的报告期间、修订状态、8-K 项目和来源链接仍是独立字段。
• 所请求的基础表格，例如 10-K 可以包含 10-K/A；调用方可以排除修订文件，也可以明确请求某个修订表格。
• 结果先按受理时间降序排列，再按申报编号降序排列。

完整发布

搜索、身份和文件均从一个已接受的发布头读取。集合响应包含一个 as_of 时间戳和游标绑定到该快照及原始筛选条件。

获取、解析、验证或对账运行失败时，不能发布部分快照。在更新候选版本通过所有检查之前，上一次完整发布仍具有权威性。

更新设计

近期申报发现会与官方批量提交和申报索引进行核对。使用响应中的 as_of 时间戳评估可用快照。

首版发布限制

第一个切片返回发行人身份和申报元数据。不提供申报正文、附件、全文搜索、XBRL 事实、CUSIP 数据、证券主数据、财务报表、内部交易、当前内部人士持仓、13F 投资组合、提醒或交易信号。

上线群组基于已接受的 SEC 股票代码与 CIK 关联快照。它不表示每个返回的发行人都有活跃的交易所上市，也不表示每个 SEC 申报人都已覆盖。

查看 SEC 申报 API 参考 和 覆盖范围.