# Events catalog — Tickerbot Corporate events API

30 columns. Group overview from https://tickerbot.io/docs/signals/catalog/events/ · full catalog: https://tickerbot.io/docs/signals/catalog.md · concept: https://tickerbot.io/docs/signals.md

What happened or is scheduled to happen to the company: earnings, dividends, IPOs, share-capital changes, insider transactions.

## Earnings

The earnings calendar and its outcomes: dates, windows, surprises, streaks.

- [days_to_earnings](https://tickerbot.io/docs/signals/days_to_earnings.md) (integer) — Calendar days until next earnings announcement. Negative after report.
- [earnings_beat_streak](https://tickerbot.io/docs/signals/earnings_beat_streak.md) (integer) — Consecutive quarters the company has beaten consensus EPS estimates. Resets to 0 on a miss.
- [earnings_date](https://tickerbot.io/docs/signals/earnings_date.md) (date) — Next scheduled earnings announcement date. Null if not scheduled.
- [earnings_fiscal_quarter](https://tickerbot.io/docs/signals/earnings_fiscal_quarter.md) (text) — Fiscal quarter the next earnings report covers (e.g. "2026Q1"). Distinct from calendar quarter — covers companies whose fiscal year doesn't match the calendar.
- [earnings_report_time](https://tickerbot.io/docs/signals/earnings_report_time.md) (text) — When in the trading day the next earnings will be reported. One of `BMO` (before market open), `AMC` (after market close), `DMH` (during market hours).
- [last_earnings_surprise](https://tickerbot.io/docs/signals/last_earnings_surprise.md) (numeric) — `last_reported_eps − last_eps_estimate`. Signed; positive = beat.
- [last_earnings_surprise_pct](https://tickerbot.io/docs/signals/last_earnings_surprise_pct.md) (numeric) — Beat as percent of consensus.
- [last_reported_eps](https://tickerbot.io/docs/signals/last_reported_eps.md) (numeric) — Actual EPS reported in the most recent earnings announcement.
- [earnings_approaching](https://tickerbot.io/docs/signals/earnings_approaching.md) (state) — Earnings within 3 days.
- [earnings_next_week](https://tickerbot.io/docs/signals/earnings_next_week.md) (state) — Earnings 8–14 days out — useful for the lead-up swing window.
- [earnings_published](https://tickerbot.io/docs/signals/earnings_published.md) (state) — Earnings report date has passed (next earnings date is in the past).
- [earnings_this_week](https://tickerbot.io/docs/signals/earnings_this_week.md) (state) — Earnings announcement scheduled in the next 7 days.
- [earnings_today](https://tickerbot.io/docs/signals/earnings_today.md) (event) — Earnings reported today.
- [earnings_tomorrow](https://tickerbot.io/docs/signals/earnings_tomorrow.md) (state) — Earnings reported in 1 calendar day. Pair with `earnings_report_time` to know BMO vs. AMC.
- [recently_reported_earnings](https://tickerbot.io/docs/signals/recently_reported_earnings.md) (state) — Reported earnings within the last 5 days.

## Dividends

Dividend amount, schedule, and approach flags.

- [dividend](https://tickerbot.io/docs/signals/dividend.md) (numeric) — Most-recent dividend amount per share.
- [dividend_date](https://tickerbot.io/docs/signals/dividend_date.md) (date) — Date of the most-recent dividend payment.
- [dividend_frequency](https://tickerbot.io/docs/signals/dividend_frequency.md) (integer) — Payment frequency: `quarterly`, `monthly`, `semiannual`, `annual`.
- [dividend_approaching](https://tickerbot.io/docs/signals/dividend_approaching.md) (state) — The ex-dividend date falls within the next 7 days.

## IPOs

IPO dates and status, from pending through recently listed.

- [ipo_date](https://tickerbot.io/docs/signals/ipo_date.md) (date) — Date of the company's IPO, when known.
- [ipo_in_7d](https://tickerbot.io/docs/signals/ipo_in_7d.md) (state) — A firm IPO listing date falls within the next 7 days.
- [pending_ipo](https://tickerbot.io/docs/signals/pending_ipo.md) (state) — The ticker is in the IPO calendar but has not started trading.
- [recently_ipoed](https://tickerbot.io/docs/signals/recently_ipoed.md) (state) — The company listed within the last 90 days.

## Splits & share changes

Events that alter share count or float: splits, buybacks, dilution.

- [float_effective_date](https://tickerbot.io/docs/signals/float_effective_date.md) (date) — As-of date for the current float-shares figure.
- [buyback_30d](https://tickerbot.io/docs/signals/buyback_30d.md) (state) — Shares outstanding fell more than 1% over the last 30 days.
- [dilution_30d](https://tickerbot.io/docs/signals/dilution_30d.md) (state) — Shares outstanding rose more than 3% over the last 30 days.
- [split_recent](https://tickerbot.io/docs/signals/split_recent.md) (state) — A stock split occurred in the last 7 days or is scheduled within 14 days.

## Insider activity

Insider (Form 4) transaction flags: C-suite buys and sells, clustered buying.

- [insider_c_suite_buy](https://tickerbot.io/docs/signals/insider_c_suite_buy.md) (state) — A C-suite insider (CEO/CFO/COO/President/Chair) bought shares in the last 7 days.
- [insider_c_suite_sell](https://tickerbot.io/docs/signals/insider_c_suite_sell.md) (state) — A C-suite insider (CEO/CFO/COO/President/Chair) sold shares in the last 7 days.
- [insider_cluster_buy](https://tickerbot.io/docs/signals/insider_cluster_buy.md) (state) — Two or more distinct insiders bought shares in the last 14 days.
