REST 接口 · 文档目录

合作方数据 公司业绩指引 · REST 接口

业绩指引。获取来自上市公司披露的结构化业绩指引数据,包括预测每股收益(EPS)与营收。每条记录包含指引日期、财季与发布类型,并尽可能附上此前的指引值。可按代码、财季与日期区间过滤。

GET /benzinga/v1/guidance
上游时效说明

每 2 小时更新

上游历史范围

数据可追溯至 2011 年 9 月 12 日

适用场景

  • 市场情绪分析、投资策略开发、财务建模。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
datestringNo业绩指引发布日(格式 YYYY-MM-DD)。
date.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
date.gtstringNo筛选大于该值。
date.gtestringNo筛选大于或等于该值。
date.ltstringNo筛选小于该值。
date.ltestringNo筛选小于或等于该值。
tickerstringNo发布业绩指引公司的股票代码。
ticker.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
ticker.gtstringNo筛选大于该值。
ticker.gtestringNo筛选大于或等于该值。
ticker.ltstringNo筛选小于该值。
ticker.ltestringNo筛选小于或等于该值。
positioningstringNo表示某项业绩指引值相对公司披露的其他数字的呈现方式。可选值为 primary(被强调的数字)与 secondary(辅助或替代数字)
positioning.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
positioning.gtstringNo筛选大于该值。
positioning.gtestringNo筛选大于或等于该值。
positioning.ltstringNo筛选小于该值。
positioning.ltestringNo筛选小于或等于该值。
importanceintegerNo事件重要程度的主观指标,取值范围 0(最低)至 5(最高)。值必须为整数。
importance.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。值必须为整数。
importance.gtintegerNo筛选大于该值。值必须为整数。
importance.gteintegerNo筛选大于或等于该值。值必须为整数。
importance.ltintegerNo筛选小于该值。值必须为整数。
importance.lteintegerNo筛选小于或等于该值。值必须为整数。
last_updatedstringNo该记录在系统中最后一次更新的时间戳(ISO 8601 格式)。值须为纳秒整数时间戳、yyyy-mm-dd 格式的日期,或 ISO 8601 / RFC 3339 格式(例如 2024-05-28T20:27:41Z)。
last_updated.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。值须为纳秒整数时间戳、yyyy-mm-dd 格式的日期,或 ISO 8601 / RFC 3339 格式(例如 2024-05-28T20:27:41Z)。
last_updated.gtstringNo筛选大于该值。值须为纳秒整数时间戳、yyyy-mm-dd 格式的日期,或 ISO 8601 / RFC 3339 格式(例如 2024-05-28T20:27:41Z)。
last_updated.gtestringNo筛选大于或等于该值。值须为纳秒整数时间戳、yyyy-mm-dd 格式的日期,或 ISO 8601 / RFC 3339 格式(例如 2024-05-28T20:27:41Z)。
last_updated.ltstringNo筛选小于该值。值须为纳秒整数时间戳、yyyy-mm-dd 格式的日期,或 ISO 8601 / RFC 3339 格式(例如 2024-05-28T20:27:41Z)。
last_updated.ltestringNo筛选小于或等于该值。值须为纳秒整数时间戳、yyyy-mm-dd 格式的日期,或 ISO 8601 / RFC 3339 格式(例如 2024-05-28T20:27:41Z)。
fiscal_yearintegerNo该业绩指引所对应期间所属的财年。值必须为整数。
fiscal_year.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。值必须为整数。
fiscal_year.gtintegerNo筛选大于该值。值必须为整数。
fiscal_year.gteintegerNo筛选大于或等于该值。值必须为整数。
fiscal_year.ltintegerNo筛选小于该值。值必须为整数。
fiscal_year.lteintegerNo筛选小于或等于该值。值必须为整数。
fiscal_periodstringNo该业绩指引适用的财季,如 Q1、Q2、Q3 或 Q4。
fiscal_period.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
fiscal_period.gtstringNo筛选大于该值。
fiscal_period.gtestringNo筛选大于或等于该值。
fiscal_period.ltstringNo筛选小于该值。
fiscal_period.ltestringNo筛选小于或等于该值。
limitintegerNo限制返回结果的最大数量。未指定时默认为 100,允许的最大值为 50000。
sortstringNo逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 date,排序方向默认为 desc。

响应字段

字段类型说明
next_urlstring若存在,可用该值获取下一页数据。
request_idstring服务器分配的请求 ID。
resultsarray[object]本次请求的结果。
results[].benzinga_idstringBenzinga 为该业绩指引记录分配的唯一标识。
results[].company_namestring发布业绩指引的公司名称。
results[].currencystring公司发布业绩指引所用数据的计价货币,ISO 4217 代码。
results[].datestring业绩指引发布日(格式 YYYY-MM-DD)。
results[].eps_methodstring每股收益(EPS)的口径。可选值为 gaap(按公认会计原则编制的标准化财务数据)、ffo(经营性资金流 FFO,常用于评估 REITs 经营表现的非 GAAP 指标)和 adj(调整后,非 GAAP)。
results[].estimated_eps_guidancenumber公司发布业绩指引时的分析师一致预期每股收益(EPS)。该值可能高于、低于或落在公司给出的区间内。
results[].estimated_revenue_guidancenumber公司发布业绩指引时的分析师一致预期营业收入。该值可能高于、低于或落在公司给出的区间内。
results[].fiscal_periodstring该业绩指引适用的财季,如 Q1、Q2、Q3 或 Q4。
results[].fiscal_yearinteger该业绩指引所对应期间所属的财年。
results[].importanceinteger事件重要程度的主观指标,取值范围 0(最低)至 5(最高)。
results[].last_updatedstring该记录在系统中最后更新的时间戳(格式为 ISO 8601 时间戳)。
results[].max_eps_guidancenumber若公司给出区间,则为该财季预期的最高每股收益。
results[].max_revenue_guidancenumber若公司给出区间,则为该财季预期的最高营业收入。
results[].min_eps_guidancenumber若公司给出区间,则为该财季预期的最低每股收益。
results[].min_revenue_guidancenumber若公司给出区间,则为该财季预期的最低营业收入。
results[].notesstring关于该业绩指引记录的补充描述或评论。
results[].positioningstring表示某项业绩指引值相对公司披露的其他数字的呈现方式。可选值为 primary(被强调的数字)与 secondary(辅助或替代数字)
results[].previous_max_eps_guidancenumber同一财季此前发布的业绩指引中的最高每股收益。
results[].previous_max_revenue_guidancenumber同一财季此前发布的业绩指引中的最高营业收入。
results[].previous_min_eps_guidancenumber同一财季此前发布的业绩指引中的最低每股收益。
results[].previous_min_revenue_guidancenumber同一财季此前发布的业绩指引中的最低营业收入。
results[].release_typestring表示该业绩指引是随定期财报一并发布(official),还是作为计划外更新发布(preliminary)。
results[].revenue_methodstring营业收入数据的口径。可选值:gaap(按美国公认会计原则的标准化财务数据)与 adj(调整后、非 GAAP)。
results[].tickerstring发布业绩指引公司的股票代码。
results[].timestring业绩指引公布的时间,格式 HH:mm:ss。
statusenum: OK本次请求响应的状态。

响应示例

{
  "count": 1,
  "request_id": 1,
  "results": [
    {
      "benzinga_id": "682b28a9c068240001a9fded",
      "company_name": "Bath & Body Works",
      "currency": "USD",
      "date": "2025-05-19",
      "eps_method": "adj",
      "estimated_eps_guidance": 3.52,
      "estimated_revenue_guidance": 7470000000,
      "fiscal_period": "FY",
      "fiscal_year": 2025,
      "importance": 3,
      "last_updated": "2025-05-19T12:54:04Z",
      "max_eps_guidance": 3.6,
      "max_revenue_guidance": 7526000000,
      "min_eps_guidance": 3.25,
      "min_revenue_guidance": 7380000000,
      "notes": "Revenue for 2025 FY is expected to up by 1 to 3% YoY from $7.307B",
      "positioning": "primary",
      "previous_max_eps_guidance": 3.6,
      "previous_max_revenue_guidance": 7526000000,
      "previous_min_eps_guidance": 3.25,
      "previous_min_revenue_guidance": 7380000000,
      "release_type": "preliminary",
      "revenue_method": "gaap",
      "ticker": "BBWI",
      "time": "08:30:00"
    }
  ],
  "status": "OK"
}

原文:Massive 文档 ↗