Dividend Calendar
Obtain Dividend Calendars for any range of companies. It includes the following columns:
- Date: The date of the dividend.
- Adj Dividend: The adjusted dividend amount.
- Dividend: The dividend amount.
- Yield: The annualized dividend yield at the time of the dividend, as a decimal (0.0054 is 0.54%).
- Record Date: The record date of the dividend.
- Payment Date: The payment date of the dividend.
- Declaration Date: The declaration date of the dividend.
If a company does not pay any dividend, the function will mention that it was not able to find any dividend data for that company.
Also known as: dividend dates, ex-dividend date, dividend history.
Dividend Calendar in Python or via the MCP
Install the Finance Toolkit with:
pip install financetoolkit -U
Then call get_dividend_calendar as shown below.
from financetoolkit import Toolkit
toolkit = Toolkit(
["JNJ"],
api_key="FINANCIAL_MODELING_PREP_KEY",
start_date="2021-01-01",
end_date="2025-12-31",
)
toolkit.get_dividend_calendar(show_columns=["Dividend"])
Or, after setting up the Finance Toolkit MCP, ask:
What dividend per share did Johnson & Johnson pay each quarter from 2021 to 2025?
Which returns:
| date | Dividend |
|---|---|
| 2021-02-22 | 1.01 |
| 2021-05-24 | 1.06 |
| 2021-08-23 | 1.06 |
| 2021-11-22 | 1.06 |
| 2022-02-18 | 1.06 |
| 2022-05-23 | 1.13 |
| 2022-08-22 | 1.13 |
| 2022-11-21 | 1.13 |
| 2023-02-17 | 1.13 |
| 2023-05-22 | 1.19 |
| 2023-08-25 | 1.19 |
| 2023-11-20 | 1.19 |
| 2024-02-16 | 1.19 |
| 2024-05-20 | 1.24 |
| 2024-08-27 | 1.24 |
| 2024-11-26 | 1.24 |
| 2025-02-18 | 1.24 |
| 2025-05-27 | 1.3 |
| 2025-08-26 | 1.3 |
| 2025-11-25 | 1.3 |
Parameters
get_dividend_calendar accepts the following parameters.
| Parameter | Type | Description | Example |
|---|---|---|---|
overwrite | bool | Defines whether to overwrite the existing data. Defaults to False. | True |
rounding | int | Defines the number of decimal places to round the data to. Defaults to None, which uses the rounding of the Toolkit (4 unless set otherwise). | 2 |
show_columns | list[str] | None | A list of column names to keep in the result. Invalid names are reported and ignored. Defaults to None, which keeps every column. | ["Dividend", "Payment Date"] |