Skip to main content

dividends

Get historical dividend data for a given company.

Parameters

symbol: Union[str, list[str]]

Symbol to get data for. Multiple items allowed for provider(s): nasdaq.

Optional: False


start_date: Union[date, str]

Start date of the data, in YYYY-MM-DD format.

Optional: True


end_date: Union[date, str]

End date of the data, in YYYY-MM-DD format.

Optional: True


Returns

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

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.