依排程重新整理
用小型腳本每天拉取新的申報文件與數據。
閱讀指南 →所有 API
財報 API 與公司申報、大股東
透過 Narwhal 取得公司申報文件、標準化財務報表與持股 5% 以上的股東，REST 與 MCP 共用一組 API 金鑰。
首次請求
尋找公司
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies?q=microsoft" \
--header "Authorization: Bearer $NARWHAL_API_KEY"回應範例
{
"results": [
{
"id": "usa:0000789019",
"name": "Microsoft Corp",
"country": "USA",
"registry": "usa",
"status": "active",
"exchange": "XNAS",
"code": "MSFT",
"matched": "name"
}
]
}端點
GET列出公司/v1/companies
依名稱搜尋公司並取得其 ID。在其他所有呼叫中使用該 ID。
參數
q選填搜尋文字，例如公司名稱。
回應欄位
listings (on a company)欄位與公司連結的股票上市 ID，例如 XNAS:MSFT，可搭配股票路由使用。上市資料依交易所與代號完全比對且目前仍有效的條件連結，絕不依名稱。清單為空代表沒有。
完整參考文件 →
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。
完整參考文件 →
使用情境
涵蓋範圍
- 美國申報文件與財務報表。歷史資料自 2009 年起。
- 日本超過 3,800 家公司，涵蓋年報與半年報。
- 韓國目前約涵蓋一半的上市公司。
- 臺灣約 1,980 家公司。2026 年半年度報告。
- 歐盟與歐洲經濟區約 3,200 家公司，涵蓋 26 個國家，僅提供年報。
- 英國約 800 家受監管市場的公司，僅提供年報。
來源
- 美國SEC EDGAR
- 日本EDINET，金融廳
- 韓國DART，金融監督院
- 臺灣TWSE 與 TPEx 上市櫃公司
- 歐盟與歐洲經濟區ESEF 年度報告
- 英國英國受監管市場發行人
相關 API
常見問題
我可以用股票代號取代公司 ID 嗎？
是。請使用 usa:0000789019 這類識別碼，或 usa:MSFT 這類認可的股票代號別名。
申報文件發布時，我可以收到通知嗎？
所有帳戶都能設定 webhook，在申報文件發布時通知您。
財務金額會經過換算或縮放嗎？
金額為以申報文件原幣別表示的小數字串，不做換算，也不縮放為百萬單位。缺漏的項目會被省略，而申報為零的值仍為零。
如何從公司找到其股票上市資料？
公司附有其股票上市 ID 清單。可搭配股票路由取得價格、歷史、股利、股票分割與估值。股票上市資料也會帶回公司 ID，因此兩個方向都能查。
申報文件記錄
讀取申報文件日期、類型與標題，並附有官方文件的連結。
標準化財務數字
在損益表、資產負債表、現金流量、每股與股數等類別中使用 77 個標準項目。
大額持股人
取得美國、日本與韓國持股 5% 以上的股東。
從免費金鑰開始
12 個月內每月贈送 10 美元免費額度，無需綁卡。每月 10 美元免費額度，無需綁卡。