所有 API

公司財務狀況資產負債表 API

取得標準化的資產、負債與權益,並提供衍生的營運資金與淨負債,租賃負債不計入總債務。

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

首次請求

取得資產負債表

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=balance" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
回應範例
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "cash": "20935000000",
      "total_assets": "758376000000",
      "total_liabilities": "315989000000",
      "total_equity": "442387000000"
    }
  ]
}

端點

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。

回應欄位

  • cash欄位

    現金及可隨時變現的短期約當現金;銀行則為現金及存放同業款項。

  • short_term_investments欄位

    短期投資與有價證券。

  • long_term_investments欄位

    資產負債表上列為長期資產的投資。

  • receivables欄位

    客戶與其他方積欠、並歸類為流動資產的款項。

  • inventory欄位

    持有待售的商品、在製品,以及生產所用的材料或物料。

  • total_current_assets欄位

    歸類為流動的資產,通常會在營業週期或一年內變現、出售或使用。

  • working_capital欄位

    以流動資產減流動負債計算,標示為推算值。

  • ppe_net欄位

    營運中使用的有形資產,已扣除累計折舊與減損。

  • goodwill欄位

    企業併購成本超過可辨認淨資產公允價值時所認列的資產。

  • intangibles欄位

    資產負債表上認列的非實體資產,不含商譽。

  • total_assets欄位

    資產負債表上認列的資產帳面總額。

  • total_current_liabilities欄位

    分類為流動的債務,通常在營業週期或一年內清償。

  • accounts_payable欄位

    積欠供應商與其他方、並歸類為流動負債的款項。

  • deferred_revenue欄位

    遞延收入與合約負債。

  • short_term_debt欄位

    一年內到期的借款,包含長期債務的目前到期部分。

  • long_term_debt欄位

    一年後到期的借款,不含目前到期部分。

  • lease_liabilities欄位

    因租賃產生的負債,不計入總債務。

  • total_debt欄位

    短期與長期借款合計,不含租賃負債。

  • net_debt欄位

    以總債務減現金計算,不含租賃負債,標示為推算值。

  • total_liabilities欄位

    資產負債表上認列的債務帳面總額。

  • retained_earnings欄位

    分配後保留的累積利潤,或累積虧損。

  • equity_parent欄位

    歸屬於母公司業主的所有權權益。

  • noncontrolling_interest欄位

    子公司權益中歸屬於母公司以外股東的部分。

  • temporary_equity欄位

    列於負債與權益之間的可贖回非控制權益與可贖回特別股。

  • total_equity欄位

    公司的所有權權益總額,含非控制權益。

  • total_liabilities_and_equity欄位

    資產負債表上列示的負債與權益合計。

  • deposits欄位

    客戶存放於銀行的款項。

  • loans欄位

    銀行對客戶的貸款與墊款,扣除信用損失準備後的淨額。


完整參考文件 →

使用情境

載入多年的公司資料

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

閱讀指南 →

依排程重新整理

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

閱讀指南 →

不超出用量限制

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

閱讀指南 →

向代理程式詢問某家公司

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

閱讀指南 →

涵蓋範圍

  • 美國申報文件與財務報表。歷史資料自 2009 年起。
  • 日本超過 3,800 家公司,涵蓋年報與半年報。
  • 韓國目前約涵蓋一半的上市公司。
  • 臺灣約 1,980 家公司。2026 年半年度報告。
  • 歐盟與歐洲經濟區約 3,200 家公司,涵蓋 26 個國家,僅提供年報。
  • 英國約 800 家受監管市場的公司,僅提供年報。

來源

相關 API

公司獲利損益表 API

來自公司申報文件的營收、成本與利潤

探索 API →

公司資金流動的現金流量表 API

含正負號流出的營業、投資與籌資現金流量

探索 API →

每股盈餘與股利 EPS API

主要普通股類別的盈餘、股利與股數

探索 API →

財報 API 與公司分析

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

探索 API →

常見問題

總債務包含租賃負債嗎?

租賃負債不計入總債務,也不計入淨負債的計算。

資產負債表項目缺漏時會怎樣?

未申報的項目不會出現在回應中。申報文件中明確申報為零的值仍為零。

資產負債表金額使用哪種幣別?

每筆金額都以小數字串保留申報文件的幣別。Narwhal 不會換算幣別,也不會縮放為百萬單位。

營運資金

以流動資產減流動負債計算,並標示為衍生值。

淨負債

以總債務減現金計算,不含租賃。

租賃負債

單獨申報,不計入總債務。