Consensus estimates

API Enterprise

Region-wide analyst consensus estimates for a single date. One request returns, for every covered instrument in the requested region, the consensus EPS, revenue and EBITDA for each forward forecast period - up to four fiscal years, eight fiscal quarters and four calendar years - as it stood on the snapshot date.

Built for enterprise consumers: a single call replaces a per-ticker fan-out, the response is uncharged (no credits), and every row carries the full instrument-identity block so it can be joined straight onto your own security master.

A response holds several rows per date, one per forward period - up to four fiscal years, eight fiscal quarters and four calendar years. Every row states its period on both the fiscal and the calendar basis, because the two disagree for most companies: the quarter ending 31 December 2026 is Apple's fiscal FY27 Q1 and Microsoft's fiscal FY27 Q2. Use the calendar columns to compare across companies and the fiscal ones to line up against a company's own reporting; the period end date is the unambiguous key either way.

Available Data Points:

  • Date: The snapshot date the consensus is as of. (YYYY-MM-DD format).
  • Date: The specific date for which the data is retrieved (YYYY-MM-DD format).
  • Company: The name of the company issuing the security.
  • Ticker: The ticker symbol associated with the security.
  • Operating MIC: The operating Market Identifier Code of the security.
  • MIC: The Market Identifier Code (MIC) for the traded security.
  • ISIN: The International Securities Identification Number for the security.
  • FIGI: The Financial Instrument Global Identifier.
  • Share Class FIGI: The Financial Instrument Global Identifier for the share class.
  • Ortex Company ID: Unique id for a company.
  • Ortex Security ID: Unique id for a security issued by a company.
  • Ortex Tradable item ID: Unique id for a listing of a security.
  • Ortex Tradable item main indicator: Indicates if the trading item is the main trading item for the security.
  • Tradable Item Currency: The currency of the tradable item.
  • Exchange Country: The country location of the exchange.
  • Period Type: annual (fiscal year), quarterly (fiscal quarter) or calendar_year (calendarised).
  • Period End Date: The last day of the forecast period.
  • Fiscal Year / Quarter: The period on the company's own fiscal calendar.
  • Calendar Year / Quarter: The period on the calendar, for cross-company comparison.
  • Currency: The currency the estimates are quoted in.
  • Estimate As Of: When the vendor last recalculated this consensus.
  • EPS Consensus Mean / Median / High / Low: Normalized EPS per share across contributing analysts.
  • EPS Standard Deviation: Dispersion of the contributing EPS estimates.
  • EPS Num Estimates: How many analysts contribute an EPS estimate for the period.
  • Revenue Consensus Mean / Median / High / Low: Revenue, absolute in the row's currency.
  • Revenue Standard Deviation: Dispersion of the contributing revenue estimates.
  • Revenue Num Estimates: How many analysts contribute a revenue estimate.
  • EBITDA Consensus Mean / Median / High / Low: EBITDA, absolute in the row's currency.
  • EBITDA Standard Deviation: Dispersion of the contributing EBITDA estimates.
  • EBITDA Num Estimates: How many analysts contribute an EBITDA estimate.

Region, date and period type

Use region to select the universe (a region name, an ISO-2 country code, or "ALL"; defaults to US), date to select the snapshot day (defaults to the latest available), and period_type to return one period basis - omit it for all three. A weekend, a holiday or a date ahead of the latest snapshot resolves back to the most recent date that carries data.

Coverage

Analyst coverage thins with distance: expect 20-40 contributors on the next one or two fiscal years and a handful by the fourth. A statistic is null where the vendor publishes none for that period rather than being fabricated from too few inputs. Calendarised rows for companies whose fiscal year ends far from December are blended from two fiscal years by the vendor and carry no single contributor count.

Source

Consensus is compiled by S&P Capital IQ from contributing broker estimates and captured here daily. Values are the vendor's, scaled to absolute units; the date is when they were observed, which is what makes a point-in-time request possible.

Try it out! You can test the API with the trial key TEST. Simply include it in your request headers; either here, or add the header "Ortex-Api-Key": "TEST" to your http request.

Trial key restrictions: Trial keys may be limited to a specific date range and set of regions. Requests outside the allowed regions or entirely outside the allowed date range are rejected; a date window that partially overlaps the allowed range is trimmed to it, reported in meta.restriction.

Get full access! Contact [email protected]

Query Params
string
Defaults to US

Which instruments to return: a region name, a two-character ISO-2 country code, or "ALL" for the whole covered universe. Defaults to "US". An unrecognized value returns 400 invalidRegion.

date

The single date to return data for (defaults to the latest available). Format: YYYY-MM-DD.

string
enum

Which forecast periods to return. 'annual' is the company's own fiscal years (FY26, FY27, ...), 'quarterly' its fiscal quarters, and 'calendar_year' the vendor's calendarised years so companies with different year ends compare like for like. Omit for all three; every row says which it is.

Allowed:
integer

Page number within the paginated result set. Must be >= 1. Defaults to 1.

integer

Number of rows per page. The default and the maximum allowed depend on the API tier; a value above the tier maximum is rejected with 400 invalidPageSize.

string
enum
Defaults to json

Response format. "json" (default) or "csv".

Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/csv