登入取得 API 金鑰

所有 API

透過 Narwhal 使用 SEC EDGAR API

透過 Narwhal 以 JSON 取得美國申報文件記錄與標準化 XBRL 財務數字，無須自行處理原始 EDGAR 資料。

取得免費 API 金鑰

閱讀文件 →

在線97.81% uptime, last 30天295 ms 一般回應

首次請求

列出公司的申報文件

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/filings" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

回應範例

{
  "id": "usa:0000789019",
  "filings": [
    {
      "id": "usa:0000789019:0001193125-26-323660",
      "date": "2026-07-29",
      "type": "annual",
      "title": "10-K"
    }
  ]
}

端點

GET列出公司/v1/companies

依名稱搜尋公司並取得其 ID。在其他所有呼叫中使用該 ID。

參數

q選填
搜尋文字，例如公司名稱。

完整參考文件 →

GET列出公司的申報文件/v1/companies/{company_id}/filings

公司的申報文件，由新到舊，並附上每份官方文件的連結。

參數

company_id必填
公司 ID，例如 usa:0000789019，或股票代號別名，例如 usa:MSFT。
type選填
申報文件類別，例如 annual。

完整參考文件 →

GET取得標準化的公司財務報表/v1/companies/{company_id}/financials

公司的標準化財務報表，每個期間一列，以其申報幣別計。

參數

company_id必填
公司 ID，例如 usa:0000789019，或股票代號別名，例如 usa:MSFT。
period選填
annual 或 semiannual，視註冊機構而定。
statement選填
income、balance、cash_flow 或 per_share。
fields選填
以逗號分隔的項目名稱，例如 revenue,net_income。

完整參考文件 →

GET取得持股 5% 以上的股東/v1/companies/{company_id}/holders

持股 5% 以上的股東，附上申報的持股比例、股數，以及載明這些資料的申報文件。

參數

company_id必填
公司 ID，例如 usa:0000789019，或股票代號別名，例如 usa:MSFT。

完整參考文件 →

使用情境

依排程重新整理

用小型腳本每天拉取新的申報文件與數據。

閱讀指南 →

接收新申報文件通知

申報文件發布時接收 webhook 並驗證。

閱讀指南 →

載入多年的公司資料

分頁讀取長期歷史資料，並在工作中斷時接續。

閱讀指南 →

不超出用量限制

快取回應並處理 429 錯誤，不遺失請求。

閱讀指南 →

向代理程式詢問某家公司

透過 MCP 讓 LLM 代理程式讀取申報文件與財務數據。

閱讀指南 →

涵蓋範圍

美國申報文件與財務報表。歷史資料自 2009 年起。

來源

美國SEC EDGAR

相關 API

EDINET API 已上線涵蓋日本公司

日本申報文件與財務報表，已上線

DART API 已涵蓋韓國公司

韓國申報文件與財務報表，已上線

公司申報文件 API 清單與單筆紀錄

申報文件清單、單筆記錄，以及各公司的最新申報文件

財報 API 與公司分析

標準化報表、報告期間與歷史版本

MOPS API 台灣申報文件與報表

來自 data.gov.tw 上 TWSE OpenAPI 與 TPEx 開放資料的台灣公司財務數字

ESEF API 取得公司年度申報

來自 26 個歐盟與歐洲經濟區國家公司的年度報告

受規範市場公司的英國財報 API

來自英國受監管市場發行人的年度報告

常見問題

Narwhal 從 SEC EDGAR 回傳什麼？

Narwhal 回傳公司申報文件記錄、標準化財務報表，以及在附表 13D 與 13G 中申報的持股 5% 以上股東。

SEC 公司識別碼如何運作？

美國公司 ID 由 usa: 加上其 SEC Central Index Key 組成，例如 usa:0000789019。也接受股票代號別名，例如 usa:MSFT。

標準化會取代官方申報文件嗎？

SEC 申報文件仍是最終依據。Narwhal 提供 JSON 記錄與標準化數字，供您在應用程式中使用。

申報文件中繼資料

Narwhal 回傳申報文件 ID、日期、類型、標題與官方連結。

標準報表項目

XBRL 財務數字已標準化為 77 個項目，所有帳戶皆可使用。

一組 API 金鑰

透過 REST 與 MCP 使用 Narwhal 的 Filings API。