← tickerbot.io
View as markdown
Endpoints

Ticker events

GEThttps://api.tickerbot.io/v2/tickers/{ticker}/events
Deprecated — sunset 2026-10-31. Responses are unchanged until then; after that date this route may return 410 Gone. Use /v2/events?ticker=X instead.

One ticker's corporate events — dividends, splits, and insider transactions, newest first. Deprecated; use /v2/events?ticker=X.

Query parameters

stringrequired

Ticker symbol.

enum

Filter by event kind. Omit for all three merged into one timeline.

dividendCash-dividend declarations, timestamped at the ex-dividend date.
splitStock splits and reverse splits, timestamped at the execution date.
insiderOfficer and director trades — one event per reported Form 4 transaction.
string

Return events strictly before this date (YYYY-MM-DD or ISO timestamp). For back-paging, pass the previous response's next_cursor — an opaque token that resumes mid-date without dropping same-date events on the page boundary.

integerdefault 100

Page size. Max 1000.

Returns

as_ofstring

Server time this response was assembled (ISO 8601).

tickerstring

The symbol you asked for.

kindstring

The kind filter, echoed.

countnumber

Rows in this page.

next_cursorstring

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

eventsarray

Dividends, splits, and insider transactions, newest first.

Status codes

200
Success — the response shape is documented under Returns above.
400
Invalid ticker or invalid kind.

Notes

  • Sunset 2026-10-31. Every response carries Deprecation: Thu, 31 Jul 2026 00:00:00 GMT, Sunset: Sat, 31 Oct 2026 00:00:00 GMT, and a Link naming both the successor route and its docs page. The successor is a strict superset: /v2/events?ticker=X adds analyst actions plus opt-in signal firings and news, and is queryable by payload.
  • Each event carries a ts, a kind, and a payload whose shape depends on the kind — the same payload shapes /v2/events emits, so switching is a URL swap rather than a reshape.
  • Changed 2026-08-05 (bug fix, not a new shape). This route became a thin view over /v2/events, which corrected two things: insider payloads now include security_type (part of the source table's primary key), and next_cursor is the token /v2/events mints.
  • Paging was silently dropping rows before that fix. The old cursor identified already-served rows by hashing the payload, so two filings by one executive on one date that differed only by the missing security_type hashed alike — serving one discarded both. A next_cursor issued before that change now returns 400 on replay instead of restarting from the top without saying so; start the walk again.