dividends

Get historical dividend data for a given company.

Examples

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

Parameters

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

symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): fmp, nasdaq.

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

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

symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): fmp, nasdaq.

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

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

limit: int | None
Return N most recent payments.

symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): fmp, nasdaq.

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

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

limit: int | None
Default: 100
The number of data entries to return.

symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): fmp, nasdaq.

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

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

symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): fmp, nasdaq.

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

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

symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): fmp, nasdaq.

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

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

---

Returns

results: 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

symbol: str | None
Symbol representing the entity requested in the 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.

symbol: str | None
Symbol representing the entity requested in the 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.

declaration_date: date | None
Declaration date of the historical dividends.

record_date: date | None
Record date of the historical dividends.

payment_date: date | None
Payment date of the historical dividends.

adjusted_amount: float
Split-adjusted dividend amount.

dividend_yield: float | None
Dividend yield represented by the payment.

frequency: str | None
Frequency of the payment.

symbol: str | None
Symbol representing the entity requested in the 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.

factor: float | None
factor by which to multiply stock prices before this date, in order to calculate historically-adjusted stock prices.

currency: str | None
The currency in which the dividend is paid.

split_ratio: float | None
The ratio of the stock split, if a stock split occurred.

symbol: str | None
Symbol representing the entity requested in the 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.

dividend_type: str | None
The type of dividend - i.e., cash, stock.

currency: str | None
The currency in which the dividend is paid.

record_date: date | None
The record date of ownership for eligibility.

payment_date: date | None
The payment date of the dividend.

declaration_date: date | None
Declaration date of the dividend.

symbol: str | None
Symbol representing the entity requested in the 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.

currency: str | None
The currency the dividend is paid in.

declaration_date: date | None
The date of the announcement.

record_date: date | None
The record date of ownership for rights to the dividend.

payment_date: date | None
The date the dividend is paid.

symbol: str | None
Symbol representing the entity requested in the 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.