載入多年的公司資料
分頁讀取長期歷史資料，並在工作中斷時接續。
閱讀指南 →所有 API
公司資金流動的現金流量表 API
以含正負號的小數字串讀取營業、投資與籌資現金流量，包括收購、已付利息與已付稅款的負數流出。
首次請求
取得現金流量表
curl --request GET \
--url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=cash_flow" \
--header "Authorization: Bearer $NARWHAL_API_KEY"回應範例
{
"id": "usa:0000789019",
"currency": "USD",
"annual": [
{
"fy": 2026,
"end": "2026-06-30",
"operating_cash_flow": "182935000000",
"capex": "-115948000000"
}
]
}端點
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。
回應欄位
operating_cash_flow欄位營業活動產生或使用的淨現金。
investing_cash_flow欄位投資活動產生或使用的淨現金。
financing_cash_flow欄位融資活動產生或使用的淨現金。
capex欄位購置不動產、廠房及設備所支付的現金，記為負數流出。
acquisitions欄位收購所支付的現金，扣除取得的現金後的淨額，記為負數流出。
free_cash_flow欄位一律以營業現金流量加資本支出計算，資本支出記為負數的現金流出。
depreciation_amortization欄位調節稅後利潤與營業現金流時加回的折舊與攤銷。
stock_based_compensation欄位調節稅後利潤與營業現金流時加回的股份基礎給付費用。
dividends_paid欄位已支付的現金股利，記為負數流出。
share_repurchases欄位回購公司自家股票所支付的現金，記為負數流出。
fx_effect_on_cash欄位因匯率變動造成的現金增減。
interest_paid欄位已支付的利息現金，記為負數流出。
taxes_paid欄位已支付的稅款現金，扣除退稅後的淨額，記為負數流出。
net_change_in_cash欄位現金的淨增減，含匯率變動的影響。
完整參考文件 →
使用情境
涵蓋範圍
- 美國申報文件與財務報表。歷史資料自 2009 年起。
- 日本超過 3,800 家公司，涵蓋年報與半年報。
- 韓國目前約涵蓋一半的上市公司。
- 臺灣約 1,980 家公司。2026 年半年度報告。
- 歐盟與歐洲經濟區約 3,200 家公司，涵蓋 26 個國家，僅提供年報。
- 英國約 800 家受監管市場的公司，僅提供年報。
來源
- 美國SEC EDGAR
- 日本EDINET，金融廳
- 韓國DART，金融監督院
- 臺灣TWSE 與 TPEx 上市櫃公司
- 歐盟與歐洲經濟區ESEF 年度報告
- 英國英國受監管市場發行人
相關 API
常見問題
利息支出是負數嗎？
是。interest_paid 代表現金流出，帶有負號。
收購項目如何處理取得的現金？
收購項目會從收購所支付的現金中扣除取得的現金，並將該筆付款記為負數流出。
現金流量金額是以百萬為單位嗎？
不做百萬單位縮放。回應採用以原申報幣別表示的小數字串。
流出為負數
流出公司的現金記為負數。
收購付款
收購以支付的現金扣除取得的現金後列示。
已付稅款
已付稅款為扣除退稅後的淨額，記為負數流出。
從免費金鑰開始
12 個月內每月贈送 10 美元免費額度，無需綁卡。每月 10 美元免費額度，無需綁卡。