tickerbot.io
View as markdown
Coverage › Signals › Signal catalog

Events catalog

Events has five categories: Earnings, Dividends, IPOs, Splits & share changes and Insider activity. Each signal links to its full reference page.

Earnings

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

ColumnTypeDescription
days_to_earningsintegerCalendar days until next earnings announcement. Negative after report.
earnings_beat_streakintegerConsecutive quarters the company has beaten consensus EPS estimates. Resets to 0 on a miss.
earnings_datedateNext earnings announcement date. Where the company has not published one, the date is projected from its own reporting history and earnings_date_projected is true.
earnings_fiscal_quartertextEnd date of the fiscal quarter the next earnings report covers (e.g. 2026-10-31). Fiscal, not calendar: it follows the company's own fiscal year.
earnings_report_timetextWhen 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_datedateDate of the company's most recent earnings report.
last_earnings_surprisenumericlast_reported_eps − last_eps_estimate. Signed; positive = beat.
last_earnings_surprise_pctnumericReported EPS versus the consensus estimate for the same quarter, as a percent of the estimate. Reported EPS can include one-time items that consensus excludes, so a large surprise is not always an operating beat.
last_fiscal_quarter_enddateEnd date of the fiscal quarter covered by the most recent earnings report.
last_reported_epsnumericEPS as reported in the most recent earnings announcement, including one-time items.
earnings_approachingstateEarnings within 3 days.
days_to_earnings = 3 (exactly three days before the scheduled earnings date)
earnings_date_projectedflagTrue when earnings_date is our projection from the company's own reporting history rather than a published calendar date.
earnings_next_weekstateEarnings 8–14 days out — useful for the lead-up swing window.
days_to_earnings >= 8 AND days_to_earnings <= 14
earnings_publishedstateEarnings report date has passed (next earnings date is in the past).
days_to_earnings <= 0
earnings_this_weekstateEarnings announcement scheduled in the next 7 days.
0 <= days_to_earnings <= 7. Sourced from the forward earnings calendar plus the historical earnings table.
earnings_todayeventEarnings reported today.
EXISTS(ticker_earnings_history row with reported_date = today). Both pre-market and post-market reports count.
earnings_tomorrowstateEarnings reported in 1 calendar day. Pair with earnings_report_time to know BMO vs. AMC.
days_to_earnings = 1
recently_reported_earningsstateReported earnings within the last 5 days.
EXISTS(ticker_earnings_history row with reported_date in [today - 5d, today - 1d]). Captures the post-earnings reaction window.

Dividends

Dividend amount, schedule, and approach booleans.

ColumnTypeDescription
dividendnumericMost-recent dividend amount per share.
dividend_datedateEx-dividend date of the most recent dividend: own the stock before this date to receive it. The live row and history carry the same date.
dividend_frequencyintegerPayment frequency: quarterly, monthly, semiannual, annual.
dividend_payout_rationumericTrailing 12-month dividends per share divided by trailing diluted EPS (0.25 = a quarter of earnings paid out). Null when EPS is zero, negative or missing.
dividend_ttmnumericDividends per share paid over the trailing 12 months, specials included. Null when nothing went ex-dividend in that window.
ex_dividend_datedateThe nearest announced ex-dividend date; once it passes with no new one announced, the most recent one.
dividend_approachingstateThe ex-dividend date falls within the next 7 days.
ex_dividend_date between today and today + 7d

IPOs

IPO dates and status, from pending through recently listed.

ColumnTypeDescription
ipo_datedateDate of the company's IPO, when known.
ipo_in_7dstateA firm IPO listing date falls within the next 7 days.
IPO calendar listing date within 7 days
pending_ipostateThe ticker is in the IPO calendar but has not started trading.
in the IPO calendar, pre-first-trade
recently_ipoedstateThe company listed within the last 90 days.
list_date >= today − 90d

Splits & share changes

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

ColumnTypeDescription
float_effective_datedateAs-of date for the current float-shares figure.
buyback_30dstateShares outstanding fell more than 1% over the last 30 days.
shares_outstanding < 30d-ago × 0.99
dilution_30dstateShares outstanding rose more than 3% over the last 30 days.
shares_outstanding > 30d-ago × 1.03
split_recentstateA stock split occurred in the last 7 days or is scheduled within 14 days.
split execution_date between today − 7d and today + 14d

Insider activity

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

ColumnTypeDescription
insider_c_suite_buystateA top officer (CEO, CFO, COO, President or Chair) or a director bought shares on the open market in the last 7 days.
SEC Form 4 transaction code P (open-market purchase) dated within the last 7 days by an insider titled CEO, CFO, COO, President, Chairman or Director. Grants, option exercises and other acquisitions do not count. NULL for a stock with no transaction-coded insider filings on record.
insider_c_suite_sellstateA top officer (CEO, CFO, COO, President or Chair) or a director sold shares on the open market in the last 7 days.
SEC Form 4 transaction code S (open-market sale) dated within the last 7 days by an insider titled CEO, CFO, COO, President, Chairman or Director. Tax withholding, gifts and dispositions to the issuer do not count. NULL for a stock with no transaction-coded insider filings on record.
insider_cluster_buystateTwo or more different insiders bought shares on the open market in the last 14 days.
count(distinct insiders with an SEC Form 4 transaction code P, open-market purchase) >= 2 within the last 14 days. NULL for a stock with no transaction-coded insider filings on record.