quantverse.
data / reference / ref.corp.actions.dividends

Cash dividends ref.corp.actions.dividends

Cash distributions by ex-date, across the symbol lineage, with a computed knowledge date. Declared-but-unpaid ones included.

PIT · Core tier · 2004-01 → today · 600k rows

Countries: US

Available now.

Methodology

Each cash distribution is served under its ex-date, the date the price adjusts; further distributions sharing that ex-date are kept apart by seq. Declaration, record and pay dates are carried when known, and amounts are exact decimals sent as strings, in the currency paid. Lineage, sweeps and knowledge time work as for splits: known_as_of filters on the computed known_since, which is the day the warehouse first observed the row, or, for history backfilled before the September 2026 go-live, the declaration date (the ex-date when that is missing) — an approximation, not an observation. Without a pin, declared distributions not yet paid are included. A restated amount is served at its current-best value whatever the pin; last_observed_at reveals it, and source_count and disputed report how well it is corroborated. Ticker lineage conflicts return 409 ERR_LINEAGE_CONFLICT until reference data is repaired. Retrying unchanged evidence cannot repair them. Temporary KeyDB failures return 503 ERR_UNAVAILABLE. Retry with backoff. Both ticker and sweep GET/HEAD responses carry a strong ETag over the exact JSON page, including metadata and next_cursor. A matching If-None-Match returns bodyless 304 after normal quota and service work. This validator detects changed answers without freezing a paginated walk.

Schema

ColumnTypeRole
ex_datedatePIT key · event date
tickerstringsymbol traded under on ex_date
seqint160 for the day's ordinary distribution
cash_amountdecimalcash per share · JSON string
currencystringcurrency paid in
declaration_datedateannounced · nullable
record_datedateholder of record · nullable
pay_datedatepaid · nullable
frequencyint16distributions per year · nullable
distribution_typestringrecurring · special · supplemental · irregular · unknown
known_sincedateearliest date knowable · computed
first_observed_attimestampfirst seen by the warehouse · UTC
last_observed_attimestamplast seen · reveals a restatement
source_countint32independent providers reporting it
disputedboolproviders disagree on the numbers
companyobjectbest-effort name · nullable

Use cases

  • Build a total-return series from cash amounts on the ex-date.
  • Keep a dividend out of a backtest until its computed knowledge date, with known_as_of.
  • Separate specials from recurring distributions when screening on yield.

Background

Related packages

See pricing · all packages