CayøLargo
← Back to siteAPI ReferencePricingChangelog
v1.0Swagger ↗

Instruments

List options instruments

Returns Deribit option instruments with optional filtering. Results are ordered by coin, expiry, strike, type.

GET/v1/instruments/optionscoreproalpha

Query Parameters

coinstringoptional

Filter by underlying asset.

e.g.BTCETHSOLBNBXRP
option_typestringoptional

Filter by option type.

e.g.callput
is_activebooleanoptional

Filter by active listing status.

e.g.truefalse
expiry_datestringoptional

Filter by expiration date in UTC. Format: YYYY-MM-DD.

e.g.2025-03-282025-06-27
limitintegeroptional

Max rows returned. Defaults to your tier row limit, which is also the ceiling: see Tiers and Limits. The catalogue holds over 129,000 instruments, so narrow with coin and expiry_date rather than raising this.

e.g.5005000

Response Schema

Fields marked pro require a Pro subscription. Fields marked alpha require Alpha.

FieldTypeTierDescription
coinstringcoreUnderlying asset: BTC, ETH, SOL, BNB, XRP, TRX.
instrument_idintegercoreInternal primary key. Stable across updates.
instrument_namestringcoreDeribit canonical name, e.g. BTC-28MAR25-80000-C.
underlying_assetstringcoreIndex name as reported by Deribit, e.g. btc_usd.
option_typestringcorecall or put.
strikefloatcoreStrike price in USD.
expiration_timestampdatetimecoreExpiry in UTC, ISO 8601.
is_activebooleancoreTrue if the instrument is currently listed.
settlement_periodstringcoreSettlement frequency: day, week, month.
contract_sizefloatcoreSize of one contract in base currency. Needed for USD notional: OI x contract_size x spot. Varies by coin: BTC=1, ETH=1, SOL=10, AVAX=100, XRP=1000, TRX=10000.
base_currencystringcoreBase currency of the contract, e.g. BTC.
quote_currencystringcoreQuote currency, e.g. USD.
min_trade_amountfloatcoreMinimum tradeable quantity per order.
tick_sizefloatcoreMinimum price increment.
creation_timestampdatetimecoreWhen Deribit listed this instrument, UTC.