historical
Get candles for any listed Deribit instrument.
Examples
from openbb import obb
# Daily candles for the BTC perpetual.
obb.deribit.futures.historical(symbol='BTC-PERPETUAL', provider='deribit')
# Hourly candles over a named span.
obb.deribit.futures.historical(symbol='BTC-PERPETUAL', interval='1h', start_date='2026-09-01', end_date='2026-09-15', provider='deribit')
Parameters
- standard
- deribit
symbol: str | list[str]
Symbol to get data for. Multiple items allowed for provider(s): deribit.
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
Symbol to get data for. Any listed instrument works, not only futures. A perpetual can also be given by its shortened root, such as 'SOLUSDC'.
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: str | None
Default: 1d
Time interval of the data to return.
Choices
- 1m
- 3m
- 5m
- 10m
- 15m
- 30m
- 1h
- 2h
- 3h
- 6h
- 12h
- 1d
Returns
results: DeribitFuturesHistorical
Serializable results.
provider: str | None
Provider name.
warnings: Optional[list[Warning_]]
List of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- deribit
date: date | datetime | str
The date of the data.
open: float | None
The open price.
high: float | None
The high price.
low: float | None
The low price.
close: float
The close price.
volume: float | None
The trading volume.
date: date | datetime | str
The date of the data.
open: float | None
The open price.
high: float | None
The high price.
low: float | None
The low price.
close: float
The close price.
volume: float | None
The trading volume.
symbol: str | None
The name of the instrument.
volume_notional: float | None
The volume of the candle, in quote currency.