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

Name	Type	Description	Default	Optional
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True

Name	Type	Description	Default	Optional
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True

Name	Type	Description	Default	Optional
start_date	Union[date, str]	Start date of the data, in YYYY-MM-DD format.	None	True
end_date	Union[date, str]	End date of the data, in YYYY-MM-DD format.	None	True

---

Returns

OBBject
    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

Name	Type	Description
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.

Name	Type	Description
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.
label	str	Ex-dividend date formatted for display.

Name	Type	Description
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.