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 參考 和 覆蓋範圍.