官方SEC meta數據
Narwhal 保留公司別名、備案時間戳記、修訂狀態和規範 SEC 連結。它不會將備案元數據轉化為分析。
閱讀方法說明 →所有 API
SEC 申報 API
按名稱、ticker或 CIK 搜尋公司並查找 SEC 申報元數據
首次請求
快速入門 →按公司名稱、股票代碼或十位 CIK 查找覆蓋範圍內的 SEC 發行人。
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies?query=AAPL&limit=20" \
--header "Authorization: Bearer $NARWHAL_API_KEY"回應範例 示例回應 · 並非實時請求
{
"query": "AAPL",
"companies": [
{
"id": "cmp_a1b2c3d4e5f678901234567890abcdef",
"name": "Apple Inc.",
"cik": "0000320193",
"listings": [
{
"ticker": "AAPL",
"exchange": "Nasdaq"
}
]
}
],
"next_cursor": null,
"as_of": "2026-08-29T12:00:00Z"
}端點
GET搜尋公司/v1/companies
按公司名稱、股票代碼或十位 CIK 查找覆蓋範圍內的 SEC 發行人。
query- 公司名稱、股票代碼或十位 CIK。名稱和股票代碼匹配不區分大小寫。
limit- 返回公司的最大數量。預設為 20。
cursor- 來自上一頁的續接令牌。它綁定到原始查詢和篩選條件。
MCP · companies_search
GET取得公司身分/v1/companies/{company_id}
將一個穩定的 Narwhal 公司 ID 解析為其 SEC 身份、上市資訊、行業代碼和曾用名。
company_id- 公司搜尋返回的穩定公司身份。股票代碼和 CIK 仍是別名，不是永久路由身份。
MCP · companies_get
GET列出公司申報文件/v1/companies/{company_id}/filings
按公司列出 SEC 備案元數據，包括 10-K、10-Q、8-K、Form 4 和 13F-HR。
company_id- 公司搜尋返回的穩定公司身份。股票代碼和 CIK 仍是別名，不是永久路由身份。
forms- 表格標記區分大小寫。基礎表格也會匹配其 /A 修訂版本，除非排除了修訂文件。
filed_from- 包含的提交日期下限。
filed_to- 不包含的提交日期上限，必須晚於 filed_from。
include_amendments- 請求基礎表格時包含修訂件。預設為 true。
limit- 返回申報文件的最大數量。預設為 50。
cursor- 來自上一頁的續接令牌。它綁定到原始查詢和篩選條件。
MCP · companies_list_filings
來源與方法論
穩定 身份
公司名稱或股票代碼變化時，公司 ID 仍保持穩定。
申報文件元數據
表格、日期、修訂和 SEC 連結均明確保留。
覆蓋範圍
查看覆蓋範圍 →常見問題
我可以按股票代碼或 CIK 搜尋嗎？
是。搜尋接受公司名稱、股票代碼或十位 CIK。
申報結果包含什麼？
表格、提交日期、接受時間、修訂狀態、報告期和規範 SEC 連結。
可以篩選哪些 SEC 表格？
已覆蓋申報歷史中的任意精確表格，包括 10-K、10-Q、8-K、20-F、Form 4、13F-HR 及其修訂文件。
是否包含申報文件正文或 XBRL 數據？
不是。本合約僅涵蓋公司身份和備案元數據。