Events
Dividends
Cash-dividend declarations as events on the unified timeline — kind=dividend on GET /v2/events. Cross-ticker, SQL-filterable, timestamped at the ex-dividend date. Future-dated declarations appear as soon as they're announced, so the stream reads as a dividend calendar too.
Payload
Every dividend event's payload carries the full declaration.
| field | meaning |
|---|---|
amount | Cash amount per share (USD) |
ex_date | Ex-dividend date — also the event's ts |
pay_date | Payment date |
record_date | Record date |
declared_date | Declaration date |
dividend_type | Type code — CD (regular cash) or SC (special); some vendor rows carry recurring |
frequency | Payments per year (4 = quarterly) |
Recipes
Filter params for the common cases; the q grammar for everything else.
# NVDA's dividend history
curl "https://api.tickerbot.io/v2/events?kind=dividend&ticker=NVDA" \
-H "Authorization: Bearer YOUR_KEY"
# Upcoming ex-dates across the top 100 (the calendar read)
curl "https://api.tickerbot.io/v2/events?kind=dividend&universe=top_100&since=2026-07-30" \
-H "Authorization: Bearer YOUR_KEY"
# 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 "since=2026-01-01" \
--data-urlencode "q=payload->>'dividend_type'='SC' AND (payload->>'amount')::numeric > 1"Latency: dividends land with the evening ET ingestion pipeline (daily). To be pushed instead of polling, subscribe with POST /v2/events/subscribe and kinds=dividend. Single-ticker spelling: /v2/tickers/{ticker}/events.