Narwhal 文件
繁體中文
API 參考網站
瀏覽全部文件

SEC 申報 API 參考

公司搜尋、穩定身份和申報元數據。使用 Narwhal API 密鑰即可獲得

基礎 URL 和身份

REST 基礎路徑
https://api.narwhalapi.com/v1/companies
  • 搜尋支援公司名稱、ticker或補零的十位 CIK。
  • 每個返回的公司都有一個穩定的不透明 company_id。股票代碼和 CIK 仍作為別名。
  • REST 與 MCP 使用相同的輸入和輸出架構。
請求
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies?query=AAPL&limit=20" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

三個首發版本操作

每項操作都有一個 REST 路徑和一個 MCP 工具，並使用相同的輸入和輸出結構。

操作REST 路徑MCP 工具
搜尋公司/v1/companiescompanies_search
取得公司身分/v1/companies/{company_id}companies_get
列出公司申報文件/v1/companies/{company_id}/filingscompanies_list_filings

共享行為

  • 集合結果使用確定性排序和不透明游標，而不是偏移量或頁碼。
  • 游標綁定到規範化查詢、公司 ID、limit 以及每個申報篩選條件。
  • 搜尋和申報頁面帶有一個 UTC as_of 完整發布快照的時間。
  • 未知公司 ID 會返回 404 company_not_found。已知公司沒有匹配的申報文件時，會返回空陣列。
  • 無效的表格、日期、游標或分頁輸入會返回 400 invalid_query.
  • 成功的 REST 與 MCP 回應使用共用的 Narwhal 額度。

首版發布範圍

第一個版本僅包含元數據和規範 SEC 連結。不包含申報正文、附件、XBRL 事實、全文搜尋、CUSIP 數據、財務報表、標準化內部交易、機構持倉、提醒或交易信號。

覆蓋範圍僅限於已接受的發行方群體。回應包含發布的 as_of 時間。請讀取 公司方法 適用於身份、修訂和快照規則。