OpenBB/website/content/platform/reference/fa/divs.md

title, description

title	description
divs	OpenBB Platform Function

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

divs

Historical Dividends. Historical dividends data for a given company.

divs(symbol: Union[str, List[str]], provider: Literal[str] = fmp)

---

Parameters

Name	Type	Description	Default	Optional
symbol	Union[str, List[str]]	Symbol to get data for.		False
provider	Literal['fmp']	The provider to use for the query, by default None. If None, the provider specified in defaults is selected or 'fmp' if there is no default.	fmp	True

---

Returns

OBBject
    results : List[HistoricalDividends]
        Serializable results.

    provider : Optional[Literal['fmp']]
        Provider name.

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

    chart : Optional[Chart]
        Chart object.

    metadata: Optional[Metadata]
        Metadata info about the command execution.

---

Data

Name	Type	Description
date	date	Date of the historical dividends.
label	str	Label of the historical dividends.
adj_dividend	float	Adjusted dividend of the historical dividends.
dividend	float	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.