Events
Splits
Stock splits and reverse splits as events on the unified timeline — kind=split on GET /v2/events, timestamped at the execution date. Bars and indicators are already split-adjusted everywhere else in the API; this stream is where the split itself is the fact you want.
Payload
A split is a ratio: split_from shares become split_to shares.
| field | meaning |
|---|---|
split_from | Share count before (1 in a 10-for-1 forward split) |
split_to | Share count after (10 in a 10-for-1 forward split) |
ratio | split_to / split_from — above 1 is a forward split (NVDA 10-for-1: ratio 10), below 1 a reverse split (1-for-8 consolidation: ratio 0.125) |
Recipes
The ratio field makes forward vs reverse a one-liner.
# All splits this quarter
curl "https://api.tickerbot.io/v2/events?kind=split&since=2026-07-01" \
-H "Authorization: Bearer YOUR_KEY"
# Reverse splits only (ratio < 1), this year
curl -G "https://api.tickerbot.io/v2/events" \
-H "Authorization: Bearer YOUR_KEY" \
--data-urlencode "kind=split" \
--data-urlencode "since=2026-01-01" \
--data-urlencode "q=(payload->>'ratio')::numeric < 1"Latency: splits land with the evening ET ingestion pipeline (daily). Push instead of poll: POST /v2/events/subscribe with kinds=split.