Earnings Screener

查询单只股票各报告期的财报实际值与一致预期。

GET/api/v1/earnings/screener
数据域
财报与预期
解析层级
资产
MCP 工具
REST-only

可查询数据

返回数据
查询单只股票各报告期的财报实际值与一致预期
每次返回什么
填写schema_version=earnings_screener.v1,并提供entity_id或带市场前缀的symbol。已验证示例返回partial:查看coverage与comparison_status,缺失值不等于0。仅支持REST。

认证

所有请求需携带 Authorization: Bearer YOUR_API_KEY 或 X-API-KEY。

请求参数

结构版本
schema_versionstringquery必填

结构版本,固定填写 earnings_screener.v1。 · earnings_screener.v1

request_idstringquery可选

请求标识

公司定位

entity_id与带市场前缀的symbol至少填写一项,例如US.AAPL

entity_idstringquery可选

实体标识;entity_id 与带市场前缀的 symbol 至少填写一项

symbolstringquery示例US.AAPL可选

带市场前缀的股票代码,例如 US.AAPL;与 entity_id 至少填写一项

marketstringquery可选

股票市场代码。 · us_equity / hk_equity / kr_equity

报告期
period_typestringquery可选

报告期类型:季度、年度或全部。 · quarterly / annual / all · 默认: quarterly

period_limitintegerquery可选

返回报告期数量,默认15,范围1–15。 · ≥ 1, ≤ 15

返回选项
include_actualbooleanquery可选

包含已披露实际值。 · 默认: true

include_forecastbooleanquery可选

包含预期值。 · 默认: true

响应

schema_versionstring

结构版本,固定填写 earnings_screener.v1

request_idstring

请求标识

data_statusDataStatus

数据状态

empty_reasonunknown | null

空结果原因

marketMarket

市场代码

entity_idstring

主体标识,标识公司、项目方或协议等主体

available_period_types[]string[]

可用报告期类型

available_metrics[]string[]

可用指标

selected_period_typestring

当前报告期类型

latest_periodstring

最新报告期

period_countnumber

返回报告期数量

periods[]object[]

报告期明细

period_keystring

报告期标识

period_labelstring

报告期名称

period_typestring

报告期类型:季度、年度或全部

fiscal_yearnumber

财年

fiscal_quarternumber

财季

report_datedatetime

披露日期

report_statusstring

披露状态

revenue_actualnumber

实际营收

revenue_estimatenumber

预期营收

revenue_actual_yoynumber

实际营收同比(比例)

revenue_estimate_yoynumber

预期营收同比(比例)

revenue_surprise_absnumber

营收超预期绝对值

revenue_surprise_pctnumber

营收超预期比例

eps_actualnumber

实际每股收益

eps_estimatenumber

预期每股收益

eps_actual_yoynumber

实际每股收益同比(比例)

eps_estimate_yoynumber

预期每股收益同比(比例)

eps_surprise_absnumber

每股收益超预期绝对值

eps_surprise_pctnumber

每股收益超预期比例

currencystring

币种

eps_basisstring

每股收益计算口径

announcement_cutoff_utcunknown | null

公告截止时间(UTC),缺失时为null

comparison_statusstring

实际值与预期值可比状态

data_statusDataStatus

数据状态

empty_reasonunknown | null

空结果原因

summaryobject

汇总

period_keystring

报告期标识

revenue_actualnumber

实际营收

eps_actualnumber

实际每股收益

revenue_surprise_pctnumber

营收超预期比例

eps_surprise_pctnumber

每股收益超预期比例

coverageobject

覆盖与缺失说明

requested_period_limitnumber

requested_period_limit

available_period_countnumber

available_period_count

returned_period_countnumber

returned_period_count

history_insufficientboolean

history_insufficient

period_continuitystring

period_continuity

history_startstring

history_start

history_endstring

history_end

source_statusstring

source_status

source_refsobject

source_refs

source_tables[]string[]

source_tables

actual_ownerstring

actual_owner

generated_atdatetime

generated_at

错误与降级

200
assets_resolve 名称多命中;从 data[] 候选确认。
200
对象已解析但无可用数据;empty_reason 可为 not_covered_by_source / unsupported_metric / limited_depth。
400
参数无效,或行情 listing 多命中;歧义响应含 required_params + candidates。
401
缺少 API Key,或 Key 无效。
403
当前 Key 的 scope 或套餐无权访问该数据域。
404
请求的资源不存在;数据源不覆盖不归入 404。
402
Credits 或月度额度耗尽。
429
请求频率超限;body 返回 retry_after,响应头同步返回 Retry-After。