Dividends by Ticker
GET/v1/dividends/{ticker}
Retrieve dividend history for a ticker: ex-date, record and payment dates, declaration date, cash amount, adjusted dividend, yield and payment frequency. Results are ordered by ex-date descending. Ideal for income investing screens, dividend calendars and total-return analysis.
Use cases
- Dividend yield and income portfolio analysis
- Ex-dividend calendar and
cash-flowplanning - Total-return studies that include distributions
- Screening for consistent dividend payers
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| ticker(*) | string | Ticker. |
| limit | integer | Max results (default 500). |
Output parameters
| Field | Type | Description |
|---|---|---|
| results | array | Dividend records, 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 dividend records returned. |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.get_dividends("AAPL")
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": "AAPL",
"ex_date": "2026-02-09",
"record_date": "2026-02-09",
"payment_date": "2026-02-12",
"declaration_date": "2026-01-29",
"adj_dividend": 0.26,
"dividend": 0.26,
"dividend_yield": 0.3787051198,
"frequency": "Quarterly"
}
],
"count": 26
}