View as markdown
Endpoints · Analyst

List analyst events

GEThttps://api.tickerbot.io/v2/analyst/events

Filter-based reader over the analyst_events archive (per-event analyst actions back to 2012). The same feed powers the recent_* analyst flags on /v2/scan and the consensus snapshot columns on the ticker object — this endpoint gives you the underlying discrete events.

All filter params are AND-combined, and at least one of ticker, tickers, since, until, firm, or action is required (an unfiltered full-history scan is rejected with 400). Rows come back newest-first (timestamp DESC, then event_id ASC); page older with the cursor from a prior response. When a cursor is supplied, every filter except limit is ignored.

Plan access

Available on every plan, alongside the live `last_rating_date` / `last_rating_firm` / `last_rating_action` columns on the ticker object and the `recent_*` analyst flags on /v2/scan.

Rate limit

Hobby 600/min · Pro 6,000/min · Scale 60,000/min.

Per-call cap

Scale/Enterprise: 1000 rows. History back to 2012.

Query parameters

string

Single-ticker filter. Takes precedence over `tickers`.

string

Comma-separated ticker filter. Max 50 symbols.

string

Events at or after this instant. ISO date or datetime.

string

Events strictly before this instant. ISO date or datetime.

string

Case-insensitive analyst-firm match.

string

Exact rating-action filter.

integerdefault 50

Page size. Max 1000 on Scale/Enterprise.

string

Opaque pagination cursor from a prior response's `next_cursor`. Ignores all filters except `limit`.

Status codes

200
Envelope with as_of, query, count, next_cursor, and results.
400
bad_request — no filter supplied, too many tickers (>50), invalid since/until, or unknown action.