合作方数据财报业绩 · REST 接口

财报业绩。获取上市公司的历史与未来财报公告，包含每股收益（EPS）、营收与分析师预期等关键指标。每条记录给出实际值、预期值与超预期指标，并可附带财季、确认状态与事件重要性等上下文，适合用于分析、自动化与投资工具。

GET /benzinga/v1/earnings

上游时效说明

实时更新

上游历史范围

数据可追溯至 2010 年 4 月 30 日

适用场景

财报日历跟踪、财务建模、事件驱动预警、市场研究。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`date`	string	No	财报计划发布或已发布的日历日期（格式 YYYY-MM-DD）。
`date.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`date.gt`	string	No	筛选大于该值。
`date.gte`	string	No	筛选大于或等于该值。
`date.lt`	string	No	筛选小于该值。
`date.lte`	string	No	筛选小于或等于该值。
`ticker`	string	No	发布财报公司的股票代码。
`ticker.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`ticker.gt`	string	No	筛选大于该值。
`ticker.gte`	string	No	筛选大于或等于该值。
`ticker.lt`	string	No	筛选小于该值。
`ticker.lte`	string	No	筛选小于或等于该值。
`importance`	integer	No	事件重要程度的主观指标，取值范围 0（最低）至 5（最高）。值必须为整数。
`importance.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。值必须为整数。
`importance.gt`	integer	No	筛选大于该值。值必须为整数。
`importance.gte`	integer	No	筛选大于或等于该值。值必须为整数。
`importance.lt`	integer	No	筛选小于该值。值必须为整数。
`importance.lte`	integer	No	筛选小于或等于该值。值必须为整数。
`last_updated`	string	No	该记录在系统中最后一次更新的时间戳（ISO 8601 格式）。值须为以秒为单位的整数时间戳、yyyy-mm-dd 格式的日期，或 ISO 8601 / RFC 3339 格式（例如 2024-05-28T20:27:41Z）。
`last_updated.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。值须为以秒为单位的整数时间戳、yyyy-mm-dd 格式的日期，或 ISO 8601 / RFC 3339 格式（例如 2024-05-28T20:27:41Z）。
`last_updated.gt`	string	No	筛选大于该值。值须为以秒为单位的整数时间戳、yyyy-mm-dd 格式的日期，或 ISO 8601 / RFC 3339 格式（例如 2024-05-28T20:27:41Z）。
`last_updated.gte`	string	No	筛选大于或等于该值。值须为以秒为单位的整数时间戳、yyyy-mm-dd 格式的日期，或 ISO 8601 / RFC 3339 格式（例如 2024-05-28T20:27:41Z）。
`last_updated.lt`	string	No	筛选小于该值。值须为以秒为单位的整数时间戳、yyyy-mm-dd 格式的日期，或 ISO 8601 / RFC 3339 格式（例如 2024-05-28T20:27:41Z）。
`last_updated.lte`	string	No	筛选小于或等于该值。值须为以秒为单位的整数时间戳、yyyy-mm-dd 格式的日期，或 ISO 8601 / RFC 3339 格式（例如 2024-05-28T20:27:41Z）。
`date_status`	string	No	表示财报日期是否已确认。可选值包括：projected、confirmed。
`date_status.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`date_status.gt`	string	No	筛选大于该值。
`date_status.gte`	string	No	筛选大于或等于该值。
`date_status.lt`	string	No	筛选小于该值。
`date_status.lte`	string	No	筛选小于或等于该值。
`eps_surprise_percent`	number	No	实际每股收益与预期每股收益的差异百分比。值必须为浮点数。
`eps_surprise_percent.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。值必须为浮点数。
`eps_surprise_percent.gt`	number	No	筛选大于该值。值必须为浮点数。
`eps_surprise_percent.gte`	number	No	筛选大于或等于该值。值必须为浮点数。
`eps_surprise_percent.lt`	number	No	筛选小于该值。值必须为浮点数。
`eps_surprise_percent.lte`	number	No	筛选小于或等于该值。值必须为浮点数。
`revenue_surprise_percent`	number	No	实际营业收入与预期营业收入的差异百分比。值必须为浮点数。
`revenue_surprise_percent.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。值必须为浮点数。
`revenue_surprise_percent.gt`	number	No	筛选大于该值。值必须为浮点数。
`revenue_surprise_percent.gte`	number	No	筛选大于或等于该值。值必须为浮点数。
`revenue_surprise_percent.lt`	number	No	筛选小于该值。值必须为浮点数。
`revenue_surprise_percent.lte`	number	No	筛选小于或等于该值。值必须为浮点数。
`fiscal_year`	integer	No	财报期所属的财年。值必须为整数。
`fiscal_year.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。值必须为整数。
`fiscal_year.gt`	integer	No	筛选大于该值。值必须为整数。
`fiscal_year.gte`	integer	No	筛选大于或等于该值。值必须为整数。
`fiscal_year.lt`	integer	No	筛选小于该值。值必须为整数。
`fiscal_year.lte`	integer	No	筛选小于或等于该值。值必须为整数。
`fiscal_period`	string	No	财报对应的财务报告期，例如 Q1、Q2、H1、FY。
`fiscal_period.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`fiscal_period.gt`	string	No	筛选大于该值。
`fiscal_period.gte`	string	No	筛选大于或等于该值。
`fiscal_period.lt`	string	No	筛选小于该值。
`fiscal_period.lte`	string	No	筛选小于或等于该值。
`limit`	integer	No	限制返回结果的最大数量。未指定时默认为 100，允许的最大值为 50000。
`sort`	string	No	逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 last_updated，排序方向默认为 desc。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	本次请求的结果。
`results[].actual_eps`	number	公司该期间实际报告的每股收益（EPS）。
`results[].actual_revenue`	number	公司该报告期实际报告的营业收入。
`results[].benzinga_id`	string	Benzinga 为该记录分配的标识。
`results[].company_name`	string	发布财报的公司名称。
`results[].currency`	string	数据报告所用计价货币的 ISO 4217 代码。
`results[].date`	string	财报计划发布或已发布的日历日期（格式 YYYY-MM-DD）。
`results[].date_status`	string	表示财报日期是否已确认。可选值包括：projected、confirmed。
`results[].eps_method`	string	每股收益（EPS）的口径。可选值为 gaap（按公认会计原则编制的标准化财务数据）、ffo（经营性资金流 FFO，常用于评估 REITs 经营表现的非 GAAP 指标）和 adj（调整后，非 GAAP）。
`results[].eps_surprise`	number	实际每股收益与预期每股收益之差。
`results[].eps_surprise_percent`	number	实际每股收益与预期每股收益的差异百分比。
`results[].estimated_eps`	number	该期间的分析师一致预期每股收益（EPS）。
`results[].estimated_revenue`	number	该期间的分析师一致预期营业收入。
`results[].fiscal_period`	string	财报对应的财务报告期，例如 Q1、Q2、H1、FY。
`results[].fiscal_year`	integer	财报期所属的财年。
`results[].importance`	integer	事件重要程度的主观指标，取值范围 0（最低）至 5（最高）。
`results[].last_updated`	string	该记录在系统中最后更新的时间戳（格式为 ISO 8601 时间戳）。
`results[].notes`	string	与财报事件相关的补充背景、评论或说明。
`results[].previous_eps`	number	公司上一可比期间报告的每股收益（EPS）。
`results[].previous_revenue`	number	公司上一可比报告期的营业收入。
`results[].revenue_method`	string	营业收入数据的口径。可选值：gaap（按美国公认会计原则的标准化财务数据）、adj（调整后、非 GAAP，剔除一次性费用或资产剥离等特定项目）与 rental（专门来自租赁业务的收入，常见于 REIT、租赁公司等以租赁为核心模式的机构）。
`results[].revenue_surprise`	number	实际营业收入与预期营业收入之差。
`results[].revenue_surprise_percent`	number	实际营业收入与预期营业收入的差异百分比。
`results[].ticker`	string	发布财报公司的股票代码。
`results[].time`	string	财报的预定发布或实际发布时间（24 小时制 HH:MM:SS，美东时间）。
`status`	enum: OK	本次请求响应的状态。

响应示例

{
  "count": 1,
  "request_id": 1,
  "results": [
    {
      "actual_eps": -0.19,
      "actual_revenue": 17566000,
      "benzinga_id": "651bcd8d7e4d6000011f2232",
      "company_name": "Guardforce AI Co",
      "currency": "USD",
      "date": "2029-09-24",
      "date_status": "confirmed",
      "eps_method": "GAAP",
      "fiscal_period": "H1",
      "fiscal_year": 2024,
      "importance": 1,
      "last_updated": "2025-01-07T10:19:50Z",
      "previous_eps": -0.75,
      "previous_revenue": 18413292,
      "revenue_method": "GAAP",
      "ticker": "GFAI",
      "time": "07:00:00"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

合作方数据 财报业绩 · REST 接口

适用场景

查询参数

响应字段

响应示例

合作方数据财报业绩 · REST 接口