所有 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 不做换算,也不缩放为百万。

营运资本

按流动资产减流动负债计算,并标注为衍生值。

净债务

按总债务减现金计算,不含租赁。

租赁负债

单独列示,不计入总债务。