載入多年的公司資料
分頁讀取長期歷史資料，並在工作中斷時接續。
閱讀指南 →所有 API
每股盈餘與股利 EPS API
取得公司主要普通股類別的每股盈餘、每股股利與流通在外股數。
首次請求
取得每股數據
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=per_share" \
--header "Authorization: Bearer $NARWHAL_API_KEY"回應範例
{
"id": "usa:0000789019",
"currency": "USD",
"annual": [
{
"fy": 2026,
"end": "2026-06-30",
"eps_basic": "18.00",
"eps_diluted": "17.95"
}
]
}端點
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。
回應欄位
eps_basic欄位以基本加權平均股數計算的主要普通股類別每股損益。
eps_diluted欄位考量稀釋性潛在普通股後，主要普通股類別的每股損益。
dividend_per_share欄位主要普通股類別每股宣告的股利。
shares_outstanding欄位主要普通股類別的流通在外股數，不含庫藏股。
weighted_shares_basic欄位期間內流通在外普通股的加權平均股數，用於計算基本每股盈餘。
weighted_shares_diluted欄位用於計算稀釋每股盈餘的普通股加權平均股數，含稀釋性潛在普通股。
完整參考文件 →
使用情境
涵蓋範圍
- 美國申報文件與財務報表。歷史資料自 2009 年起。
- 日本超過 3,800 家公司，涵蓋年報與半年報。
- 韓國目前約涵蓋一半的上市公司。
- 臺灣約 1,980 家公司。2026 年半年度報告。
- 歐盟與歐洲經濟區約 3,200 家公司，涵蓋 26 個國家，僅提供年報。
- 英國約 800 家受監管市場的公司，僅提供年報。
來源
- 美國SEC EDGAR
- 日本EDINET，金融廳
- 韓國DART，金融監督院
- 臺灣TWSE 與 TPEx 上市櫃公司
- 歐盟與歐洲經濟區ESEF 年度報告
- 英國英國受監管市場發行人
相關 API
常見問題
這些數字涵蓋所有股份類別嗎？
EPS、每股股利與流通在外股數皆是指主要普通股類別。
缺少股利數字代表是零嗎？
缺漏的股利項目會被省略，不會以零填補。申報為零的值則回傳為零。
每股項目是免費的嗎？
這 77 個標準項目，包括每股與股數項目，所有帳戶皆可使用，Companies 價格為每 1,000 次呼叫 10 美元。
每股盈餘
EPS 數字是指主要普通股類別。
每股股利
股利金額同樣是指公司的主要普通股類別。
流通在外股數
股數沿用相同的主要普通股類別基準。
從免費金鑰開始
12 個月內每月贈送 10 美元免費額度，無需綁卡。每月 10 美元免費額度，無需綁卡。