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
| Column | Type | Role |
|---|---|---|
ex_date | date | PIT key · event date |
ticker | string | symbol traded under on ex_date |
seq | int16 | 0 for the day's ordinary distribution |
cash_amount | decimal | cash per share · JSON string |
currency | string | currency paid in |
declaration_date | date | announced · nullable |
record_date | date | holder of record · nullable |
pay_date | date | paid · nullable |
frequency | int16 | distributions per year · nullable |
distribution_type | string | recurring · special · supplemental · irregular · unknown |
known_since | date | earliest date knowable · computed |
first_observed_at | timestamp | first seen by the warehouse · UTC |
last_observed_at | timestamp | last seen · reveals a restatement |
source_count | int32 | independent providers reporting it |
disputed | bool | providers disagree on the numbers |
company | object | best-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
- ref.identifiers — CIK · CUSIP · FIGI mappings
- ref.corp.actions.splits — Share splits
- ref.corp.actions.ma — Mergers & acquisitions
- ref.listings — Listings · delistings · halts