所有 API

公司盈利情况的利润表 API

读取公司披露文件中的标准化营业收入、成本和利润,成本为正数,计算值有标注,并分别列示归属母公司和合并净利润。

在线97.81% uptime, last 30天295 ms 典型响应

首次请求

获取利润表

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=income" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
响应示例
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "revenue": "331839000000",
      "gross_profit": "225465000000",
      "operating_income": "155237000000",
      "net_income": "133749000000"
    }
  ]
}

端点

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。

响应字段

  • revenue字段

    销售收入总额,扣除退货和折让;银行和保险公司留空。

  • cost_of_revenue字段

    当期销售商品和提供服务的营业成本。

  • gross_profit字段

    报告收入减营业成本;银行和保险公司留空。

  • research_and_development字段

    研究和开发产品、服务或流程的费用。

  • selling_general_administrative字段

    销售产品和服务、管理业务以及一般行政管理的费用。

  • selling_marketing字段

    销售和营销活动的费用,记为正的成本。

  • general_administrative字段

    一般行政管理费用,记为正的成本。

  • operating_expenses字段

    列为营业费用的费用总额。

  • operating_income字段

    经营活动产生的利润或亏损。

  • ebit字段

    由营业利润得出,否则为税前利润加利息支出;银行和保险公司不提供。

  • ebitda字段

    由息税前利润加折旧与摊销计算得出,标注为推算值。

  • interest_income字段

    以利息形式获得的收入;银行业为利息及股息收入总额。

  • interest_expense字段

    借款及其他附息债务的利息费用,以正数列示。

  • net_interest_income字段

    银行的利息收入减去利息支出。

  • noninterest_income字段

    银行除利息之外来源的全部收入。

  • noninterest_expense字段

    银行除利息支出之外的全部费用。

  • provision_for_credit_losses字段

    银行的信用损失计提,作为费用时显示为正数。

  • premiums_earned字段

    保险公司在本期内确认为已赚取的保费,扣除分出再保险后的净额。

  • policy_benefits字段

    保险公司在本期内发生的保单给付和赔款支出。

  • pretax_income字段

    持续经营业务的税前收入或亏损。

  • income_tax字段

    所得税费用或收益;为费用时显示为正数。

  • net_income字段

    归属于母公司的税后净利润,不含非控制性权益。

  • net_income_parent字段

    归属于母公司所有者的净利润

  • net_income_to_common字段

    扣除优先股股息后可供普通股股东分配的净利润。

  • discontinued_ops_income字段

    终止经营业务收入,扣除税项后的净额。

  • net_income_including_nci字段

    税后合并净利润,包含归属于非控制性权益的部分。

  • net_income_noncontrolling字段

    归属于母公司以外子公司所有者的利润或亏损。

  • comprehensive_income字段

    综合收益总额,按此口径列报时含少数股东权益

  • jp_ordinary_income字段

    仅日本适用的利润,包含经营和非经营业绩,未计特别项目和税项,与美国公认会计准则或国际财务报告准则均无直接对应项。


完整参考文档 →

使用场景

加载多年的公司数据

分页读取较长的历史,任务中断后可以继续。

阅读指南 →

按计划刷新

用一个小脚本每天拉取新的披露文件和数据。

阅读指南 →

不超出你的限额

缓存响应并处理 429 错误,避免丢失请求。

阅读指南 →

向智能体询问某家公司

通过 MCP 让 LLM 智能体读取披露文件和财务数据。

阅读指南 →

覆盖范围

  • 美国披露文件与财务报表。历史数据始于 2009 年。
  • 日本超过 3,800 家公司,含年度和半年度数据。
  • 韩国目前已覆盖约一半的上市公司。
  • 台湾约 1,980 家公司。2026 年半年度报告。
  • 欧盟和欧洲经济区约 3,200 家公司,覆盖 26 个国家,仅年度数据。
  • 英国约 800 家受监管市场上的公司,仅年度数据。

来源

相关 API

公司财务状况的资产负债表 API

资产、负债、权益及衍生的资产负债表项目

探索 API →

公司现金流动的现金流量表 API

经营、投资和筹资现金流,流出带符号

探索 API →

EPS API:每股收益与股息

主要普通股类别的收益、股息和股数

探索 API →

面向公司分析的财务报表 API

标准化报表、报告期间和历史版本

探索 API →

常见问题

银行和保险公司如何列示?

银行和保险公司的营业收入与毛利为空。它们披露的是利息收入或保费。

EBIT 如何计算?

EBIT 在有营业利润时使用营业利润,否则使用税前利润加利息费用。它是衍生值,不适用于银行或保险公司。

三个净利润项目分别代表什么?

net_income 是母公司应占部分,不含非控股权益。net_income_including_nci 是含非控股权益的合并总额。net_income_parent 是单独的项目,表示归属母公司所有者的净利润。

正数成本

利润表中的成本为正数。

归属母公司净利润

net_income 是母公司应占部分;net_income_including_nci 包含非控股权益。

标注的计算值

衍生项目均有标识,包括计算得出的 EBIT 和 EBITDA。