Skip to main content
Analyst estimates capture the sell-side view: per-firm estimates, ratings, price targets, and revisions over time. Estimates are point-in-time, use as_of to see the consensus an agent would have had on a given date.

​
Analyst estimates

GET /analyst-estimates
ParameterTypeRequiredDefaultDescription
scenario_idstringYes-The world to read from.
tickerstringYes-Ticker symbol to query.
as_ofdateNolatestReturn only estimates visible on or before this date.
limitintegerNo50Page size (max 200).
offsetintegerNo0Pagination offset.
curl -s "https://api.davidhf.com/analyst-estimates?scenario_id=<id>&ticker=AAPL&as_of=2026-03-27" \
  -H "X-API-KEY: YOUR_API_KEY"

{
  "analyst_estimates": [
    {
      "id": "est_...",
      "ticker": "AAPL",
      "firm": "Morgan Stanley",
      "analyst": "J. Rivera",
      "estimate_date": "2026-03-12",
      "fiscal_period": "Q2 2026",
      "metric_name": "eps",
      "estimate": 2.05,
      "currency": "USD",
      "rating": "overweight",
      "target_price": 215.0,
      "prior_target_price": 205.0,
      "revision_pct": 0.049,
      "metadata": { "...": "..." }
    }
  ]
}
Estimates carry a revision_pct and prior_target_price, so you can track the phased revision behavior that follows scenario events like earnings surprises and guidance changes.

Analyst notes

Full-text sell-side notes.

Earnings

Consensus vs. actuals and surprises.