[options] Current data

GET /v1/options/:exchange_id/current

Get current options data for a specific exchange.

Returns option data grouped by underlying asset, quote currency, and expiration time, with quotes for both calls and puts at each strike price.

Request

Path Parameters

exchange_id stringrequired

Exchange identifier (from the Metadata -> Exchanges)

Responses

successful operation

text/plain
application/json
text/json
application/x-msgpack

Schema
Example (from schema)
Example response

Schema

Array [

asset_id_base stringnullable

The base asset identifier.

asset_id_quote stringnullable

The quote asset identifier.

underlying_price doublenullable

The underlying price of the option.

time_expiration date-time

The expiration time of the option.

strikes

object[]

nullable

The list of strikes available.

Array [

strike_price double

The strike price.

call

object

Represents a quote trade data model.

symbol_id stringnullable

The symbol identifier.

time_exchange date-time

The exchange time of the quote trade.

time_coinapi date-time

The CoinAPI time when the quote trade was received.

ask_price doublenullable

The best asking price.

ask_size doublenullable

The volume resting on the best ask. If the value is equal to zero, then the size is unknown.

bid_price doublenullable

The best bidding price.

bid_size doublenullable

The volume resting on the best bid. If the value is equal to zero, then the size is unknown.

last_trade

object

Represents the last executed transaction.

time_exchange date-time

The exchange time of the last trade.

time_coinapi date-time

The CoinAPI time when the last trade was received.

uuid uuid

The UUID of the last trade.

price double

The price of the last trade.

size double

The size of the last trade.

taker_side stringnullable

The taker side of the last trade.

put

object

Represents a quote trade data model.

symbol_id stringnullable

The symbol identifier.

time_exchange date-time

The exchange time of the quote trade.

time_coinapi date-time

The CoinAPI time when the quote trade was received.

ask_price doublenullable

The best asking price.

ask_size doublenullable

The volume resting on the best ask. If the value is equal to zero, then the size is unknown.

bid_price doublenullable

The best bidding price.

bid_size doublenullable

The volume resting on the best bid. If the value is equal to zero, then the size is unknown.

last_trade

object

Represents the last executed transaction.

time_exchange date-time

The exchange time of the last trade.

time_coinapi date-time

The CoinAPI time when the last trade was received.

uuid uuid

The UUID of the last trade.

price double

The price of the last trade.

size double

The size of the last trade.

taker_side stringnullable

The taker side of the last trade.

]

]

[
  {
    "asset_id_base": "string",
    "asset_id_quote": "string",
    "underlying_price": 0,
    "time_expiration": "2024-11-26T19:36:39.804Z",
    "strikes": [
      {
        "strike_price": 0,
        "call": {
          "symbol_id": "string",
          "time_exchange": "2024-11-26T19:36:39.804Z",
          "time_coinapi": "2024-11-26T19:36:39.804Z",
          "ask_price": 0,
          "ask_size": 0,
          "bid_price": 0,
          "bid_size": 0,
          "last_trade": {
            "time_exchange": "2024-11-26T19:36:39.804Z",
            "time_coinapi": "2024-11-26T19:36:39.804Z",
            "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "price": 0,
            "size": 0,
            "taker_side": "string"
          }
        },
        "put": {
          "symbol_id": "string",
          "time_exchange": "2024-11-26T19:36:39.804Z",
          "time_coinapi": "2024-11-26T19:36:39.804Z",
          "ask_price": 0,
          "ask_size": 0,
          "bid_price": 0,
          "bid_size": 0,
          "last_trade": {
            "time_exchange": "2024-11-26T19:36:39.804Z",
            "time_coinapi": "2024-11-26T19:36:39.804Z",
            "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "price": 0,
            "size": 0,
            "taker_side": "string"
          }
        }
      }
    ]
  }
]

[
  {
    "asset_id_base": "BTC",
    "asset_id_quote": "USD",
    "underlying_price": 770,
    "time_expiration": "2013-09-28T22:40:50.0000000Z",
    "strikes": [
      {
        "strike_price": 770,
        "call": {
          "symbol_id": "DERIBIT_OPT_BTC-28SEP28_77000",
          "time_exchange": "0001-01-01T00:00:00.0000000Z",
          "time_coinapi": "0001-01-01T00:00:00.0000000Z",
          "ask_price": 770,
          "ask_size": 3252,
          "bid_price": 760,
          "bid_size": 124,
          "last_trade": {
            "time_exchange": "2017-03-18T22:42:21.3763342Z",
            "time_coinapi": "2017-03-18T22:42:21.3763342Z",
            "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2",
            "price": 770,
            "size": 0.05,
            "taker_side": "SELL"
          }
        },
        "put": {
          "symbol_id": "DERIBIT_OPT_BTC-28SEP28_77000",
          "time_exchange": "0001-01-01T00:00:00.0000000Z",
          "time_coinapi": "0001-01-01T00:00:00.0000000Z",
          "ask_price": 770,
          "ask_size": 3252,
          "bid_price": 760,
          "bid_size": 124,
          "last_trade": {
            "time_exchange": "2017-03-18T22:42:21.3763342Z",
            "time_coinapi": "2017-03-18T22:42:21.3763342Z",
            "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2",
            "price": 770,
            "size": 0.05,
            "taker_side": "SELL"
          }
        }
      }
    ]
  }
]

Schema
Example (from schema)
Example response

Schema

Array [

asset_id_base stringnullable

The base asset identifier.

asset_id_quote stringnullable

The quote asset identifier.

underlying_price doublenullable

The underlying price of the option.

time_expiration date-time

The expiration time of the option.

strikes

object[]

nullable

The list of strikes available.

Array [

strike_price double

The strike price.

call

object

Represents a quote trade data model.

symbol_id stringnullable

The symbol identifier.

time_exchange date-time

The exchange time of the quote trade.

time_coinapi date-time

The CoinAPI time when the quote trade was received.

ask_price doublenullable

The best asking price.

ask_size doublenullable

The volume resting on the best ask. If the value is equal to zero, then the size is unknown.

bid_price doublenullable

The best bidding price.

bid_size doublenullable

The volume resting on the best bid. If the value is equal to zero, then the size is unknown.

last_trade

object

Represents the last executed transaction.

time_exchange date-time

The exchange time of the last trade.

time_coinapi date-time

The CoinAPI time when the last trade was received.

uuid uuid

The UUID of the last trade.

price double

The price of the last trade.

size double

The size of the last trade.

taker_side stringnullable

The taker side of the last trade.

put

object

Represents a quote trade data model.

symbol_id stringnullable

The symbol identifier.

time_exchange date-time

The exchange time of the quote trade.

time_coinapi date-time

The CoinAPI time when the quote trade was received.

ask_price doublenullable

The best asking price.

ask_size doublenullable

The volume resting on the best ask. If the value is equal to zero, then the size is unknown.

bid_price doublenullable

The best bidding price.

bid_size doublenullable

The volume resting on the best bid. If the value is equal to zero, then the size is unknown.

last_trade

object

Represents the last executed transaction.

time_exchange date-time

The exchange time of the last trade.

time_coinapi date-time

The CoinAPI time when the last trade was received.

uuid uuid

The UUID of the last trade.

price double

The price of the last trade.

size double

The size of the last trade.

taker_side stringnullable

The taker side of the last trade.

]

]

[
  {
    "asset_id_base": "string",
    "asset_id_quote": "string",
    "underlying_price": 0,
    "time_expiration": "2024-11-26T19:36:39.806Z",
    "strikes": [
      {
        "strike_price": 0,
        "call": {
          "symbol_id": "string",
          "time_exchange": "2024-11-26T19:36:39.806Z",
          "time_coinapi": "2024-11-26T19:36:39.806Z",
          "ask_price": 0,
          "ask_size": 0,
          "bid_price": 0,
          "bid_size": 0,
          "last_trade": {
            "time_exchange": "2024-11-26T19:36:39.806Z",
            "time_coinapi": "2024-11-26T19:36:39.806Z",
            "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "price": 0,
            "size": 0,
            "taker_side": "string"
          }
        },
        "put": {
          "symbol_id": "string",
          "time_exchange": "2024-11-26T19:36:39.806Z",
          "time_coinapi": "2024-11-26T19:36:39.806Z",
          "ask_price": 0,
          "ask_size": 0,
          "bid_price": 0,
          "bid_size": 0,
          "last_trade": {
            "time_exchange": "2024-11-26T19:36:39.806Z",
            "time_coinapi": "2024-11-26T19:36:39.806Z",
            "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "price": 0,
            "size": 0,
            "taker_side": "string"
          }
        }
      }
    ]
  }
]

[
  {
    "asset_id_base": "BTC",
    "asset_id_quote": "USD",
    "underlying_price": 770,
    "time_expiration": "2013-09-28T22:40:50.0000000Z",
    "strikes": [
      {
        "strike_price": 770,
        "call": {
          "symbol_id": "DERIBIT_OPT_BTC-28SEP28_77000",
          "time_exchange": "0001-01-01T00:00:00.0000000Z",
          "time_coinapi": "0001-01-01T00:00:00.0000000Z",
          "ask_price": 770,
          "ask_size": 3252,
          "bid_price": 760,
          "bid_size": 124,
          "last_trade": {
            "time_exchange": "2017-03-18T22:42:21.3763342Z",
            "time_coinapi": "2017-03-18T22:42:21.3763342Z",
            "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2",
            "price": 770,
            "size": 0.05,
            "taker_side": "SELL"
          }
        },
        "put": {
          "symbol_id": "DERIBIT_OPT_BTC-28SEP28_77000",
          "time_exchange": "0001-01-01T00:00:00.0000000Z",
          "time_coinapi": "0001-01-01T00:00:00.0000000Z",
          "ask_price": 770,
          "ask_size": 3252,
          "bid_price": 760,
          "bid_size": 124,
          "last_trade": {
            "time_exchange": "2017-03-18T22:42:21.3763342Z",
            "time_coinapi": "2017-03-18T22:42:21.3763342Z",
            "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2",
            "price": 770,
            "size": 0.05,
            "taker_side": "SELL"
          }
        }
      }
    ]
  }
]

Schema
Example (from schema)
Example response

Schema

Array [

asset_id_base stringnullable

The base asset identifier.

asset_id_quote stringnullable

The quote asset identifier.

underlying_price doublenullable

The underlying price of the option.

time_expiration date-time

The expiration time of the option.

strikes

object[]

nullable

The list of strikes available.

Array [

strike_price double

The strike price.

call

object

Represents a quote trade data model.

symbol_id stringnullable

The symbol identifier.

time_exchange date-time

The exchange time of the quote trade.

time_coinapi date-time

The CoinAPI time when the quote trade was received.

ask_price doublenullable

The best asking price.

ask_size doublenullable

The volume resting on the best ask. If the value is equal to zero, then the size is unknown.

bid_price doublenullable

The best bidding price.

bid_size doublenullable

The volume resting on the best bid. If the value is equal to zero, then the size is unknown.

last_trade

object

Represents the last executed transaction.

time_exchange date-time

The exchange time of the last trade.

time_coinapi date-time

The CoinAPI time when the last trade was received.

uuid uuid

The UUID of the last trade.

price double

The price of the last trade.

size double

The size of the last trade.

taker_side stringnullable

The taker side of the last trade.

put

object

Represents a quote trade data model.

symbol_id stringnullable

The symbol identifier.

time_exchange date-time

The exchange time of the quote trade.

time_coinapi date-time

The CoinAPI time when the quote trade was received.

ask_price doublenullable

The best asking price.

ask_size doublenullable

The volume resting on the best ask. If the value is equal to zero, then the size is unknown.

bid_price doublenullable

The best bidding price.

bid_size doublenullable

The volume resting on the best bid. If the value is equal to zero, then the size is unknown.

last_trade

object

Represents the last executed transaction.

time_exchange date-time

The exchange time of the last trade.

time_coinapi date-time

The CoinAPI time when the last trade was received.

uuid uuid

The UUID of the last trade.

price double

The price of the last trade.

size double

The size of the last trade.

taker_side stringnullable

The taker side of the last trade.

]

]

[
  {
    "asset_id_base": "string",
    "asset_id_quote": "string",
    "underlying_price": 0,
    "time_expiration": "2024-11-26T19:36:39.807Z",
    "strikes": [
      {
        "strike_price": 0,
        "call": {
          "symbol_id": "string",
          "time_exchange": "2024-11-26T19:36:39.807Z",
          "time_coinapi": "2024-11-26T19:36:39.807Z",
          "ask_price": 0,
          "ask_size": 0,
          "bid_price": 0,
          "bid_size": 0,
          "last_trade": {
            "time_exchange": "2024-11-26T19:36:39.807Z",
            "time_coinapi": "2024-11-26T19:36:39.807Z",
            "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "price": 0,
            "size": 0,
            "taker_side": "string"
          }
        },
        "put": {
          "symbol_id": "string",
          "time_exchange": "2024-11-26T19:36:39.807Z",
          "time_coinapi": "2024-11-26T19:36:39.807Z",
          "ask_price": 0,
          "ask_size": 0,
          "bid_price": 0,
          "bid_size": 0,
          "last_trade": {
            "time_exchange": "2024-11-26T19:36:39.807Z",
            "time_coinapi": "2024-11-26T19:36:39.807Z",
            "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "price": 0,
            "size": 0,
            "taker_side": "string"
          }
        }
      }
    ]
  }
]

[
  {
    "asset_id_base": "BTC",
    "asset_id_quote": "USD",
    "underlying_price": 770,
    "time_expiration": "2013-09-28T22:40:50.0000000Z",
    "strikes": [
      {
        "strike_price": 770,
        "call": {
          "symbol_id": "DERIBIT_OPT_BTC-28SEP28_77000",
          "time_exchange": "0001-01-01T00:00:00.0000000Z",
          "time_coinapi": "0001-01-01T00:00:00.0000000Z",
          "ask_price": 770,
          "ask_size": 3252,
          "bid_price": 760,
          "bid_size": 124,
          "last_trade": {
            "time_exchange": "2017-03-18T22:42:21.3763342Z",
            "time_coinapi": "2017-03-18T22:42:21.3763342Z",
            "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2",
            "price": 770,
            "size": 0.05,
            "taker_side": "SELL"
          }
        },
        "put": {
          "symbol_id": "DERIBIT_OPT_BTC-28SEP28_77000",
          "time_exchange": "0001-01-01T00:00:00.0000000Z",
          "time_coinapi": "0001-01-01T00:00:00.0000000Z",
          "ask_price": 770,
          "ask_size": 3252,
          "bid_price": 760,
          "bid_size": 124,
          "last_trade": {
            "time_exchange": "2017-03-18T22:42:21.3763342Z",
            "time_coinapi": "2017-03-18T22:42:21.3763342Z",
            "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2",
            "price": 770,
            "size": 0.05,
            "taker_side": "SELL"
          }
        }
      }
    ]
  }
]

Schema
Example (from schema)
Example response

Schema

Array [

asset_id_base stringnullable

The base asset identifier.

asset_id_quote stringnullable

The quote asset identifier.

underlying_price doublenullable

The underlying price of the option.

time_expiration date-time

The expiration time of the option.

strikes

object[]

nullable

The list of strikes available.

Array [

strike_price double

The strike price.

call

object

Represents a quote trade data model.

symbol_id stringnullable

The symbol identifier.

time_exchange date-time

The exchange time of the quote trade.

time_coinapi date-time

The CoinAPI time when the quote trade was received.

ask_price doublenullable

The best asking price.

ask_size doublenullable

The volume resting on the best ask. If the value is equal to zero, then the size is unknown.

bid_price doublenullable

The best bidding price.

bid_size doublenullable

The volume resting on the best bid. If the value is equal to zero, then the size is unknown.

last_trade

object

Represents the last executed transaction.

time_exchange date-time

The exchange time of the last trade.

time_coinapi date-time

The CoinAPI time when the last trade was received.

uuid uuid

The UUID of the last trade.

price double

The price of the last trade.

size double

The size of the last trade.

taker_side stringnullable

The taker side of the last trade.

put

object

Represents a quote trade data model.

symbol_id stringnullable

The symbol identifier.

time_exchange date-time

The exchange time of the quote trade.

time_coinapi date-time

The CoinAPI time when the quote trade was received.

ask_price doublenullable

The best asking price.

ask_size doublenullable

The volume resting on the best ask. If the value is equal to zero, then the size is unknown.

bid_price doublenullable

The best bidding price.

bid_size doublenullable

The volume resting on the best bid. If the value is equal to zero, then the size is unknown.

last_trade

object

Represents the last executed transaction.

time_exchange date-time

The exchange time of the last trade.

time_coinapi date-time

The CoinAPI time when the last trade was received.

uuid uuid

The UUID of the last trade.

price double

The price of the last trade.

size double

The size of the last trade.

taker_side stringnullable

The taker side of the last trade.

]

]

[
  {
    "asset_id_base": "string",
    "asset_id_quote": "string",
    "underlying_price": 0,
    "time_expiration": "2024-11-26T19:36:39.808Z",
    "strikes": [
      {
        "strike_price": 0,
        "call": {
          "symbol_id": "string",
          "time_exchange": "2024-11-26T19:36:39.808Z",
          "time_coinapi": "2024-11-26T19:36:39.808Z",
          "ask_price": 0,
          "ask_size": 0,
          "bid_price": 0,
          "bid_size": 0,
          "last_trade": {
            "time_exchange": "2024-11-26T19:36:39.808Z",
            "time_coinapi": "2024-11-26T19:36:39.808Z",
            "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "price": 0,
            "size": 0,
            "taker_side": "string"
          }
        },
        "put": {
          "symbol_id": "string",
          "time_exchange": "2024-11-26T19:36:39.808Z",
          "time_coinapi": "2024-11-26T19:36:39.808Z",
          "ask_price": 0,
          "ask_size": 0,
          "bid_price": 0,
          "bid_size": 0,
          "last_trade": {
            "time_exchange": "2024-11-26T19:36:39.808Z",
            "time_coinapi": "2024-11-26T19:36:39.808Z",
            "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "price": 0,
            "size": 0,
            "taker_side": "string"
          }
        }
      }
    ]
  }
]

[
  {
    "asset_id_base": "BTC",
    "asset_id_quote": "USD",
    "underlying_price": 770,
    "time_expiration": "2013-09-28T22:40:50.0000000Z",
    "strikes": [
      {
        "strike_price": 770,
        "call": {
          "symbol_id": "DERIBIT_OPT_BTC-28SEP28_77000",
          "time_exchange": "0001-01-01T00:00:00.0000000Z",
          "time_coinapi": "0001-01-01T00:00:00.0000000Z",
          "ask_price": 770,
          "ask_size": 3252,
          "bid_price": 760,
          "bid_size": 124,
          "last_trade": {
            "time_exchange": "2017-03-18T22:42:21.3763342Z",
            "time_coinapi": "2017-03-18T22:42:21.3763342Z",
            "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2",
            "price": 770,
            "size": 0.05,
            "taker_side": "SELL"
          }
        },
        "put": {
          "symbol_id": "DERIBIT_OPT_BTC-28SEP28_77000",
          "time_exchange": "0001-01-01T00:00:00.0000000Z",
          "time_coinapi": "0001-01-01T00:00:00.0000000Z",
          "ask_price": 770,
          "ask_size": 3252,
          "bid_price": 760,
          "bid_size": 124,
          "last_trade": {
            "time_exchange": "2017-03-18T22:42:21.3763342Z",
            "time_coinapi": "2017-03-18T22:42:21.3763342Z",
            "uuid": "1ea8adc5-6459-47ca-adbf-0c3f8c729bb2",
            "price": 770,
            "size": 0.05,
            "taker_side": "SELL"
          }
        }
      }
    ]
  }
]

Was this section helpful?

[options] Current data

/v1/options/:exchange_id/current

Request​

Path Parameters

Responses​

Request

Responses