dividend

Get historical and upcoming dividend payments. Includes dividend amount, ex-dividend and payment dates.

Examples

from openbb import obb
obb.equity.calendar.dividend(provider='fmp')
# Get dividend calendar for specific dates.
obb.equity.calendar.dividend(start_date='2024-02-01', end_date='2024-02-07', provider='nasdaq')

Parameters

• standard
• fmp
• nasdaq

start_date: date | str
Start date of the data, in YYYY-MM-DD format.

end_date: date | str
End date of the data, in YYYY-MM-DD format.

start_date: date | str
Start date of the data, in YYYY-MM-DD format.

end_date: date | str
End date of the data, in YYYY-MM-DD format.

start_date: date | str
Start date of the data, in YYYY-MM-DD format.

end_date: date | str
End date of the data, in YYYY-MM-DD format.

---

Returns

results: list[CalendarDividend]

Serializable results.

provider: Optional[Literal['fmp', 'nasdaq']]

Provider name.

warnings: Optional[list[Warning_]]

list of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.

---

Data

• standard
• fmp
• nasdaq

ex_dividend_date: date
The ex-dividend date - the date on which the stock begins trading without rights to the dividend.

symbol: str
Symbol representing the entity requested in the data.

amount: float
The dividend amount per share.

name: str
Name of the entity.

record_date: date
The record date of ownership for eligibility.

payment_date: date
The payment date of the dividend.

declaration_date: date
Declaration date of the dividend.

ex_dividend_date: date
The ex-dividend date - the date on which the stock begins trading without rights to the dividend.

symbol: str
Symbol representing the entity requested in the data.

amount: float
The dividend amount per share.

name: str
Name of the entity.

record_date: date
The record date of ownership for eligibility.

payment_date: date
The payment date of the dividend.

declaration_date: date
Declaration date of the dividend.

adjusted_amount: float
The adjusted-dividend amount.

dividend_yield: float
Annualized dividend yield.

frequency: str
Frequency of the regular dividend payment.

ex_dividend_date: date
The ex-dividend date - the date on which the stock begins trading without rights to the dividend.

symbol: str
Symbol representing the entity requested in the data.

amount: float
The dividend amount per share.

name: str
Name of the entity.

record_date: date
The record date of ownership for eligibility.

payment_date: date
The payment date of the dividend.

declaration_date: date
Declaration date of the dividend.

annualized_amount: float
The indicated annualized dividend amount.