← tickerbot.io
View as markdown
Endpoints › Events

Splits

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

Stock splits and reverse splits, timestamped at the execution date.

Query parameters

stringrequiredfixed by this page

Fix to split 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). 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: ratio, split_from, split_to (numeric) — e.g. ratio < 1 for reverse splits. 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 that split.

tsstring

Execution date as an ISO timestamp.

kindstring

Always `split` on this view.

payloadobject

The split terms.

split_fromnumber

Shares before (the 1 in a 10-for-1).

split_tonumber

Shares after (the 10 in a 10-for-1).

rationumber

`split_to / split_from` — forward splits > 1, reverse splits < 1.

Notes

  • This is GET /v2/events with kind=split; it has its own page because the payload is its own contract. The full query grammar lives there and applies here unchanged.
  • The ratio field makes direction a one-liner: ratio > 1 is a forward split, ratio < 1 a reverse. 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=split.