官方SEC meta數據
來源是美國證券交易委員會。Narwhal 使用公司關聯、提交元數據和 EDGAR 申報索引。
閱讀方法說明 →所有 API
SEC 申報文件 API
查找 SEC 申報中繼資料及原始文件連結。
首次請求
快速入門 →請將 YOUR_COMPANY_ID 替換為公司搜尋傳回的 ID。 公司搜尋 API →
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/YOUR_COMPANY_ID/filings?forms=10-K,10-Q&filed_from=2020-01-01&filed_to=2027-01-01&limit=50" \
--header "Authorization: Bearer $NARWHAL_API_KEY"回應範例 示例回應 · 並非實時請求
{
"company": {
"id": "cmp_a1b2c3d4e5f678901234567890abcdef",
"name": "Apple Inc.",
"cik": "0000320193"
},
"filings": [
{
"accession_number": "0000320193-24-000123",
"form": "10-K",
"filed_on": "2024-11-01",
"accepted_at": "2024-11-01T10:01:36Z",
"report_period": "2024-09-28",
"is_amendment": false,
"items": [],
"filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.html",
"primary_document_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm"
}
],
"next_cursor": null,
"as_of": "2026-08-29T12:00:00Z"
}端點
GET列出公司申報文件/v1/companies/{company_id}/filings
company_id- 公司搜尋返回的穩定公司身份。股票代碼和 CIK 仍是別名，不是永久路由身份。
forms- 表格標記區分大小寫。基礎表格也會匹配其 /A 修訂版本，除非排除了修訂文件。
filed_from- 包含的提交日期下限。
filed_to- 不包含的提交日期上限，必須晚於 filed_from。
include_amendments- 請求基礎表格時包含修訂件。預設為 true。
limit- 返回申報文件的最大數量。預設為 50。
cursor- 來自上一頁的續接令牌。它綁定到原始查詢和篩選條件。
MCP · companies_list_filings
來源與方法論
穩定 身份
公司名稱或股票代碼變化時，公司 ID 仍保持穩定。
申報文件元數據
表格、日期、修訂和 SEC 連結均明確保留。
覆蓋範圍
查看覆蓋範圍 →常見問題
回應包含哪些內容？
按公司列出 SEC 備案元數據，包括 10-K、10-Q、8-K、Form 4 和 13F-HR。
支援哪些資料範圍？
第一個版本僅返回元數據和規範 SEC 文件連結。不包含申報正文、附件、XBRL 事實、內部交易、財務報表或 13F 持倉。
是否包含申報文件正文或 XBRL 數據？
不是。本合約僅涵蓋公司身份和備案元數據。