所有 API

EPS API:每股收益与股息

获取公司主要普通股类别的每股收益、每股股息和流通股数。

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

首次请求

获取每股数据

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字段

    用于计算稀释每股收益的普通股加权平均股数,含稀释性潜在普通股。


完整参考文档 →

使用场景

加载多年的公司数据

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

阅读指南 →

按计划刷新

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

阅读指南 →

不超出你的限额

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

阅读指南 →

向智能体询问某家公司

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

阅读指南 →

覆盖范围

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

来源

相关 API

公司盈利情况的利润表 API

来自公司披露文件的营业收入、成本和利润

探索 API →

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

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

探索 API →

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

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

探索 API →

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

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

探索 API →

常见问题

这些数据涵盖所有股份类别吗?

EPS、每股股息和流通股数均指主要普通股类别。

股息数据缺失是否意味着为零?

缺失的股息项会被省略,而不是填为零。已披露的零值则按零返回。

每股项目是否免费?

77 个标准项目(包括每股和股数项目)对所有账户开放,按 Companies 价格每 1,000 次调用 10 美元计费。

每股收益

EPS 数据指主要普通股类别。

每股股息

股息金额同样指公司的主要普通股类别。

流通股数

股数采用相同的主要普通股类别口径。