← tickerbot.io
View as markdown
Endpoints › Events

Dividends

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

Cash-dividend declarations, one event per declaration, timestamped at the ex-dividend date.

Query parameters

stringrequiredfixed by this page

Fix to dividend for this view (comma-combine kinds to merge timelines).

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). Set to today for the calendar read. 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: amount, frequency (numeric), ex_date, pay_date, record_date, declared_date (date), dividend_type (text) — e.g. amount > 1 AND frequency = 4. 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 event, newest first.

tickerstring

Symbol the declaration belongs to.

tsstring

Ex-dividend date as an ISO timestamp — the event's timeline position.

kindstring

Always `dividend` on this view.

payloadobject

The declaration.

amountnumber

Cash amount per share (USD).

ex_datestring

Ex-dividend date (same day as `ts`).

pay_datestringoptional

Payment date.

record_datestringoptional

Record date.

declared_datestringoptional

Declaration date.

dividend_typestringoptional

`CD` (regular cash) or `SC` (special); some rows carry `recurring`.

frequencynumberoptional

Payments per year (4 = quarterly).

Notes

  • This is GET /v2/events with kind=dividend; it has its own page because the payload is its own contract. The full query grammar (q, group_by/select/having, join=state, cursor rules) lives there and applies here unchanged.
  • Future-dated declarations appear as soon as they are announced, so the stream doubles as a dividend calendar. Latency: daily, via the evening ET ingestion pipeline.
  • To be pushed instead of polling, create an event-trigger webhook: POST /v2/webhooks with trigger.kinds=dividend.
  • Single-ticker scope: pass ticker=X here. (The legacy per-symbol spelling GET /v2/tickers/{ticker}/events is deprecated with a 2026-10-31 sunset.)

More examples

Special dividends over $1/share, this year
curl -G "https://api.tickerbot.io/v2/events" \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "kind=dividend" \
  --data-urlencode "from=2026-02-18" \
  --data-urlencode "q=payload->>'dividend_type'='SC' AND (payload->>'amount')::numeric > 1"
Response
// Same envelope — only rows whose payload matches the filter.