historical
Historical futures prices.
Examples
from openbb import obb
obb.derivatives.futures.historical(symbol='ES')
# Enter multiple symbols.
obb.derivatives.futures.historical(symbol='ES,NQ')
# Enter expiration dates as "YYYY-MM".
obb.derivatives.futures.historical(symbol='ES', expiration='2025-12')
Parameters
- standard
- deribit
- yfinance
symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): deribit, yfinance.
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.
expiration: str | None
Future expiry date with format YYYY-MM
symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): deribit, yfinance.
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.
expiration: str | None
Future expiry date with format YYYY-MM
interval: Literal['1m', '3m', '5m', '10m', '15m', '30m', '1h', '2h', '3h', '6h', '12h', '1d'] | None
Default: 1d
Time interval of the data to return.
symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): deribit, yfinance.
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.
expiration: str | None
Future expiry date with format YYYY-MM
interval: Literal['1m', '2m', '5m', '15m', '30m', '60m', '90m', '1h', '1d', '5d', '1W', '1M', '1Q'] | None
Default: 1d
Time interval of the data to return.
Returns
results: FuturesHistorical
Serializable results.
provider: Optional[Literal['deribit', 'yfinance']]
Provider name.
warnings: Optional[list[Warning_]]
list of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- deribit
- yfinance
date: datetime | str
The date of the data.
open: float
The open price.
high: float
The high price.
low: float
The low price.
close: float
The close price.
volume: float
The trading volume.
date: datetime | str
The date of the data.
open: float
The open price.
high: float
The high price.
low: float
The low price.
close: float
The close price.
volume: float
The trading volume.
volume_notional: float
Trading volume in quote currency.
date: datetime | str
The date of the data.
open: float
The open price.
high: float
The high price.
low: float
The low price.
close: float
The close price.
volume: float
The trading volume.