dividends

Get historical dividend data for a given company.

Examples

from openbb import obb
obb.equity.fundamental.dividends(symbol='AAPL', provider='intrinio')

---

Parameters

• standard
• fmp
• intrinio
• nasdaq
• tmx
• yfinance

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): nasdaq.		False
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
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): nasdaq.		False
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
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): nasdaq.		False
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
limit	int	The number of data entries to return.	100	True

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): nasdaq.		False
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
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): nasdaq.		False
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
symbol	Union[str, List[str]]	Symbol to get data for. Multiple items allowed for provider(s): nasdaq.		False
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[HistoricalDividends]
        Serializable results.

    provider : Optional[Literal['fmp', 'intrinio', 'nasdaq', 'tmx', 'yfinance']]
        Provider name.

    warnings : Optional[List[Warning_]]
        List of warnings.

    chart : Optional[Chart]
        Chart object.

    extra : Dict[str, Any]
        Extra info.

---

Data

• standard
• fmp
• intrinio
• nasdaq
• tmx
• yfinance

Name	Type	Description
ex_dividend_date	date	The ex-dividend date - the date on which the stock begins trading without rights to the dividend.
amount	float	The dividend amount per share.

Name	Type	Description
ex_dividend_date	date	The ex-dividend date - the date on which the stock begins trading without rights to the dividend.
amount	float	The dividend amount per share.
label	str	Label of the historical dividends.
adj_dividend	float	Adjusted dividend of the historical dividends.
record_date	date	Record date of the historical dividends.
payment_date	date	Payment date of the historical dividends.
declaration_date	date	Declaration date of the historical dividends.

Name	Type	Description
ex_dividend_date	date	The ex-dividend date - the date on which the stock begins trading without rights to the dividend.
amount	float	The dividend amount per share.
factor	float	factor by which to multiply stock prices before this date, in order to calculate historically-adjusted stock prices.
currency	str	The currency in which the dividend is paid.
split_ratio	float	The ratio of the stock split, if a stock split occurred.

Name	Type	Description
ex_dividend_date	date	The ex-dividend date - the date on which the stock begins trading without rights to the dividend.
amount	float	The dividend amount per share.
dividend_type	str	The type of dividend - i.e., cash, stock.
currency	str	The currency in which the dividend is paid.
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.
amount	float	The dividend amount per share.
currency	str	The currency the dividend is paid in.
decalaration_date	date	The date of the announcement.
record_date	date	The record date of ownership for rights to the dividend.
payment_date	date	The date the dividend is paid.

Name	Type	Description
ex_dividend_date	date	The ex-dividend date - the date on which the stock begins trading without rights to the dividend.
amount	float	The dividend amount per share.