GateData.AI

Consensus estimates

Query consensus estimates for earnings and revenue.

GET/api/v1/estimates/consensus
Domain
Estimates & Earnings
Level
Public-company entity
MCP tool
estimates_earnings_query (task=consensus)

Available data

Returns
Consensus estimates for earnings and revenue
Market coverage
US equities
Query granularity
One company per query; metric and fiscal period define the series, and different periods are not merged

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Company and event positioning

Provide at least one company or event positioning field.

querystringqueryExampleAAPLconditional

Search text used to resolve the query object

entity_idstringqueryExampleentity_sec_cik_0000320193conditional

Canonical entity identifier

asset_idstringqueryExampleasset_aapl_common_stockconditional

Canonical asset identifier

instrument_idstringqueryExampleinstrument_aapl_common_stockconditional

Canonical financial instrument identifier

listing_idstringqueryExamplelisting_aapl_xnasconditional

Canonical listing identifier

earnings_event_idstringqueryExample50d368d9fa2ec6530106a9217a74874fc1690a8c5c96b546ecf68945b94369daconditional

Canonical earnings event identifier

Query filters

All optional.

marketMarketqueryExampleus_equityoptional

Market of the query object

asset_classenumqueryExampleequityoptional

Asset class of the queried object.

venue_idstringqueryExamplevenue_xnasoptional

Trading venue identifier.

windowenumqueryExamplelatestoptional

Preset query time range

fromdatequeryExample2026-07-01optional

Start date of a custom query range

todatequeryExample2026-10-31optional

End date of a custom query range

fiscal_periodstringqueryExampleFY2026Q1optional

Company fiscal-period identifier

period_typeenumqueryExamplequarterlyoptional

Financial reporting period type

estimate_metricenumqueryExampleepsoptional

Consensus estimate metric name

include_historybooleanqueryExamplefalseoptional

Whether historical versions are returned

allow_stalebooleanqueryExamplefalseoptional

Whether stale data may be returned

limitintegerqueryExample20optional

Maximum records returned per request

Response

dataobject

Consensus estimate data

estimates[]object[]

Consensus estimate records

estimate_snapshot_idstringExample69985510d0f9c7b1acb8d6163541591616b16dc1…

Consensus estimate snapshot identifier

asset_idstringExampleasset_aapl_common_stock

Canonical asset identifier

entity_idstringExampleentity_sec_cik_0000320193

Canonical entity identifier

instrument_idstringExampleinstrument_aapl_common_stock

Canonical financial instrument identifier

listing_idstringExamplelisting_aapl_xnas

Canonical listing identifier

venue_idstringExamplevenue_xnas

Canonical trading venue identifier

estimate_periodstringExampleFY2026Q1

Fiscal period covered by the estimate

period_typeEarningsPeriodTypeExamplequarterly

Financial reporting period type

estimate_metricstringExampleeps

Consensus estimate metric name

estimate_lownumber | null

Lowest analyst estimate

estimate_avgnumberExample2.6708

Average analyst estimate

estimate_highnumber | null

Highest analyst estimate

eps_basisstringExamplebasic

Earnings-per-share calculation basis

sample_countinteger | null

Number of valid analyst estimates

forward_eps_consensusnumber | null

Forward earnings-per-share consensus

estimate_as_ofdatetimeExample2026-08-17T06:39:15.000+0000

Consensus estimate snapshot cutoff time

currencystringExampleUSD

Currency code used by the financial values

data_statusDataStatusExampleok

Availability of this business record

empty_reasonstring | null

Reason code when this record is empty

data_statusDataStatusExampleok

Availability of the business data

empty_reasonstring | null

Reason code for missing data or fields

errorobject | null

Structured error information

external_refs[]object[]

Public external evidence references

citation_urlstringExamplehttps://www.sec.gov/cgi-bin/browse-edgar…

External evidence URL

entity_idstringExampleentity_sec_cik_0000320193

Canonical entity identifier

external_ref_idstringExample0000320193

Object identifier in the external system

external_ref_typestringExampleedgar_company_filings

External reference type

external_source_domainstringExamplesec.gov

Domain of the external evidence source

lineage_refs[]object[]

Data-processing lineage references

sourcestringExampleestimates

Stable source role (e.g. estimates, calendar, results, consensus)

stagestringExamplecurrent

current or history

data_statusDataStatusExampleok

Data status at this lineage hop

source_refs[]object[]

Upstream data-source references

request_idstringExample409adb6e-55fe-4dcb-a1a9-f2577292310d

Trace id for this request

metadataobject

Response status and resolution information

object_refs[]object[]

Unified object references

typeObjectRefTypeExampleentity

Object reference type

idstringExampleentity_sec_cik_0000320193

Canonical object identifier

entity_idstringExampleentity_sec_cik_0000320193

Canonical entity identifier

asset_idstringExampleasset_aapl_common_stock

Canonical asset identifier

listing_idstringExamplelisting_aapl_xnas

Canonical listing identifier

instrument_idstringExampleinstrument_aapl_common_stock

Canonical financial instrument identifier

venue_idstringExamplevenue_xnas

Canonical trading venue identifier

resolved_fromstringExampleearnings_subject

Input used to resolve the object

resolution_confidencestring

Object resolution confidence

actual_taskstringExampleconsensus

Task that was actually executed

route_reasonstringExampleobject_resolver

Reason the task or object was selected

limitations[]string[]Examplesource_refs_unavailable

Known data limitations

updated_atdatetime | stringExample2026-08-17T17:07:24Z

Most recent object or response update time

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.