GateData.AI

财报结果

对比财报实际值与预期。

GET/api/v1/earnings/results
数据域
财报与预期
解析层级
上市公司实体
MCP 工具
estimates_earnings_query (task=results)

可查询数据

返回数据
财报实际值与预期
市场覆盖
覆盖美股
查询粒度
每次查询一家公司；财期筛选可将结果缩小到一个报告期

认证

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

请求参数

公司与事件定位

至少填写一项资产或事件定位字段。

querystringquery示例AAPL条件必须

用于解析查询对象的检索词

entity_idstringquery示例entity_sec_cik_0000320193条件必须

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

asset_idstringquery示例asset_aapl_common_stock条件必须

资产标识，标识股票、加密资产等资产对象

instrument_idstringquery示例instrument_aapl_common_stock条件必须

交易工具标识，标识股票、现货交易对或合约等具体交易产品

listing_idstringquery示例listing_aapl_xnas条件必须

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

earnings_event_idstringquery示例50d368d9fa2ec6530106a9217a74874fc1690a8c5c96b546ecf68945b94369da条件必须

规范财报事件标识

查询筛选

均为可选。

marketMarketquery示例us_equity可选

查询对象所属市场

asset_classenumquery示例equity可选

查询对象的资产类别。

venue_idstringquery示例venue_xnas可选

交易场所标识，标识交易所或交易平台

windowenumquery示例latest可选

预设查询时间窗口

fromdatequery示例2026-07-01可选

自定义查询起始日期

todatequery示例2026-10-31可选

自定义查询结束日期

fiscal_periodstringquery示例FY2025Q4可选

公司财政期间标识

period_typeenumquery示例quarterly可选

财务数据统计期间类型

allow_stalebooleanquery示例false可选

是否允许返回陈旧数据

limitintegerquery示例20可选

单次最多返回的记录数

响应

dataobject

财报结果数据容器

results[]object[]

财报结果数组

earnings_event_idstring示例0eacaaceb0500c7e5f41091a3fcccd3ed67acd53…

规范财报事件标识

asset_idstring示例asset_aapl_common_stock

资产标识，标识股票、加密资产等资产对象

entity_idstring示例entity_sec_cik_0000320193

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

instrument_idstring示例instrument_aapl_common_stock

交易工具标识，标识股票、现货交易对或合约等具体交易产品

listing_idstring示例listing_aapl_xnas

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

venue_idstring示例venue_xnas

交易场所标识，标识交易所或交易平台

fiscal_periodstring示例FY2025Q4

公司财政期间标识

result_statusstring示例reported

财报结果状态

eps_actualnumber示例1.85

实际披露的每股收益

eps_estimatenumber示例1.7699

每股收益一致预期

eps_surprisenumber示例0.08010000000000006

每股收益实际值与预期差

eps_surprise_pctnumber示例0.04525679416916213

每股收益超预期百分比

eps_basisstring示例basic

每股收益计算口径

revenue_actualnumber示例102466003000

实际披露营收

revenue_estimatenumber示例102250480000

营收一致预期

revenue_surprisenumber示例215523000

实际营收与预期差

revenue_surprise_pctnumber示例0.002107794506196939

营收超预期百分比

currencystring示例USD

财务数值使用的货币代码

estimate_as_ofdatetime示例2026-08-17T06:39:15.000+0000

一致预期快照截止时间

comparison_statusstring示例comparable

实际值与预期值可比状态

calculation_refs[]object[]

派生字段计算依据数组

fieldstring示例eps_surprise_pct

派生字段路径

formula_versionstring示例surprise_pct_v1

计算公式版本

inputs[]string[]示例eps_actual

派生值输入字段数组

data_statusDataStatus示例ok

该业务记录的数据可用状态

data_statusDataStatus示例ok

业务数据可用状态

empty_reasonstring | null

无数据或字段为空的原因码

errorobject | null

结构化错误信息

external_refs[]object[]

公开外部证据引用数组

citation_urlstring示例https://www.sec.gov/cgi-bin/browse-edgar…

外部证据链接

entity_idstring示例entity_sec_cik_0000320193

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

external_ref_idstring示例0000320193

外部系统对象标识

external_ref_typestring示例edgar_company_filings

外部引用类型

external_source_domainstring示例sec.gov

外部证据来源域名

lineage_refs[]object[]

数据处理血缘引用数组

sourcestring示例estimates

稳定来源角色（如 estimates、calendar、results、consensus）

stagestring示例current

current 或 history

data_statusDataStatus示例ok

该血缘跳的数据状态

source_refs[]object[]

上游数据来源引用数组

request_idstring示例2136e73f-57b2-488a-9386-c628440ad45a

本次请求的追踪 ID

metadataobject

响应状态与解析信息容器

object_refs[]object[]

统一对象引用数组

typeObjectRefType示例entity

对象引用类型

idstring示例entity_sec_cik_0000320193

对象标识，标识 type 指定的具体对象

entity_idstring示例entity_sec_cik_0000320193

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

asset_idstring示例asset_aapl_common_stock

资产标识，标识股票、加密资产等资产对象

listing_idstring示例listing_aapl_xnas

交易场所挂牌标识，标识某个交易品种在特定交易场所的挂牌记录

instrument_idstring示例instrument_aapl_common_stock

交易工具标识，标识股票、现货交易对或合约等具体交易产品

venue_idstring示例venue_xnas

交易场所标识，标识交易所或交易平台

resolved_fromstring示例earnings_subject

对象解析所用输入来源

resolution_confidencestring

对象解析置信度

actual_taskstring示例results

实际执行的任务类型

route_reasonstring示例object_resolver

任务或对象路由原因

limitations[]string[]示例source_refs_unavailable

已知数据限制数组

updated_atdatetime | string示例2026-08-17T17:07:23Z

对象或响应最近更新时间

错误与降级

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。