← tickerbot.io
View as markdown
Endpoints › Events

Estimate revisions

GEThttps://api.tickerbot.io/v2/events?kind=estimate_revision

Every move in the consensus EPS estimate for a company's fiscal quarter or fiscal year, as a timeline event with the old and new value. Opt in by naming estimate_revision in kind.

Query parameters

stringrequiredfixed by this page

Include estimate_revision explicitly — e.g. kind=estimate_revision alone, or merged with other kinds (kind=earnings,estimate_revision).

string

Single symbol. Beats tickers when both are passed.

string[]

Comma-separated symbols, up to 50. Not combinable with universe; ticker wins when both are passed.

string

System or caller-owned universe slug.

string

YYYY-MM-DD or ISO timestamp (inclusive). since is accepted as an alias.

string

YYYY-MM-DD or ISO timestamp — a bare YYYY-MM-DD means through the end of that day; timestamps are exclusive. until is accepted as an alias.

string

SQL filter. This kind's payload fields are first-class typed columns here: old_estimate, new_estimate, change_pct, analyst_count (numeric), fiscal_date (date), horizon, direction (text) — e.g. direction = 'down' AND change_pct < -5. payload->>'…' works too. Base columns: ticker, ts, kind, payload. See the signals catalog for columns + flags you can compose.

integerdefault 50

Rows per page. Max 1000.

string

Opaque cursor from the previous response.

Returns

as_ofstring

Server time this response was assembled (ISO 8601).

queryobject

Your filters, echoed.

countnumber

Rows in this page.

next_cursorstring

Opaque token for the next page; `null` on the last page. Pass it back as `cursor`.

resultsarray

One row per revision, newest first.

tickerstring

The company whose estimate moved.

tsstring

When the new consensus was observed (our nightly estimates refresh), not when an individual analyst filed.

kindstring

Always `estimate_revision` on this view.

payloadobject

The move.

fiscal_datestring

End of the fiscal period the estimate is for (`YYYY-MM-DD`).

horizonstring

`fiscal quarter` or `fiscal year`.

old_estimatenumber

Consensus EPS before the move.

new_estimatenumber

Consensus EPS after the move.

change_pctnumber

Change in percent of the old value's magnitude (`2.5` = 2.5%).

directionstring

`up` or `down`.

analyst_countnumberoptional

Analysts in the consensus, when the vendor reports it.

Notes

  • This is GET /v2/events with kind=estimate_revision; it has its own page because the payload is its own contract. The full query grammar lives there and applies here unchanged, including join=state.
  • History starts on August 22, 2026, when we began keeping every consensus change. A revision is recorded when the consensus EPS itself moves; changes in coverage alone (analyst count, high, low) are not revisions.
  • Latency: daily — the estimates refresh at the end of the evening ET ingestion pipeline. An unfiltered /v2/events stays the five corporate kinds, and event webhooks don't cover this kind yet.
  • The surprise on each report (reported vs estimated EPS, surprise_pct) is on the earnings kind.