Data API / Financial Data / Analyst Estimates

Analyst Estimates

Forward analyst consensus for one stock: fiscal_period, period, revenue and earnings_per_share per estimated period. ticker is required; period selects annual or quarterly and limit caps how many periods come back. Deliberately narrow — no analyst names, no ratings, no price targets, no high/low dispersion. Use it for what the street expects. For what was actually reported, and by how much it beat or missed, use get_financial_earnings.

Parameters

query

tickerstringRequired
The ticker to get analyst estimates for.
periodstringOptional
Allowed values: annual · quarterly
The period to get analyst estimates for. Use the /analyst-estimates/periods endpoint to get a list of available periods. Defaults to 'annual'.
limitintegerOptional
The maximum number of estimates to return (max 3 for annual, 12 for quarterly).

Example request

curl -G "https://openapi.felo.ai/v1/beta/financial/analyst-estimates" \
  --data-urlencode "ticker=<string>" \
  -H "Authorization: Bearer $FELO_API_KEY"

Response

Response fields

analyst_estimatesobject[]Optional
fiscal_periodstringOptional
The fiscal period of the analyst estimate.
periodstringOptional
Allowed values: annual · quarterly
The period of the analyst estimate.
revenueintegerOptional
The estimated revenue.
earnings_per_sharenumberOptional
The estimated earnings per share.