All Dividends
GET/v1/dividends
Retrieve dividend history across every ticker: ex-date, record and payment dates, declaration date, cash amount, adjusted dividend, yield and frequency. Results are ordered by ex-date descending, then ticker. Paginate with page and limit (default 50, max 250). Use this for market-wide ex-dividend calendars and income screens.
Use cases
- Market-wide ex-dividend calendars
- Cross-ticker dividend yield screens
- Income portfolio monitoring across the universe
- Bulk dividend data for total-return models
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| page | integer | Zero-based page (default 0). |
| limit | integer | Page size, 1-250 (default 50). |
Output parameters
| Field | Type | Description |
|---|---|---|
| results | array | Dividend records across tickers, most recent ex-date first. |
| results[].ticker | string | Ticker. |
| results[].ex_date | string | Ex-dividend date (YYYY-MM-DD). |
| results[].record_date | string | Record date (YYYY-MM-DD). |
| results[].payment_date | string | Payment date (YYYY-MM-DD). |
| results[].declaration_date | string | Declaration date (YYYY-MM-DD). |
| results[].adj_dividend | float | Split-adjusted dividend per share. |
| results[].dividend | float | Cash dividend per share. |
| results[].dividend_yield | float | Indicated yield at payment (percent). |
| results[].frequency | string | Payment frequency label (e.g. Quarterly). |
| count | integer | Number of rows on this page. |
| total | integer | Total matching dividend rows. |
| page | integer | Zero-based page index. |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.list_dividends(limit=50)
print(result){
"results": [
{
"ticker": "AAPL",
"ex_date": "2026-05-11",
"record_date": "2026-05-11",
"payment_date": "2026-05-14",
"declaration_date": "2026-04-30",
"adj_dividend": 0.27,
"dividend": 0.27,
"dividend_yield": 0.3587535875,
"frequency": "Quarterly"
},
{
"ticker": "MSFT",
"ex_date": "2026-05-14",
"record_date": "2026-05-15",
"payment_date": "2026-06-11",
"declaration_date": "2026-03-10",
"adj_dividend": 0.83,
"dividend": 0.83,
"dividend_yield": 0.72,
"frequency": "Quarterly"
}
],
"count": 2,
"total": 125430,
"page": 0
}