Combo Books
Public

Retrieves active combos for the specified settlement currency ("any" for every currency). Inactive, closed, and archivized combos are omitted. There is no state parameter on this method.

Each result is a combo object (id, legs, state, timestamps, instrument_id), not the full instrument spec from public/get_instrument. Combo state here is the combo-book state (active), which is not the same as the instrument order-book state.

This is not the same list as public/get_instruments with kind=future_combo or kind=option_combo, which returns visible combo instruments (including locked / halted / settlement books) and omits inactive combos.

For IDs including inactive combos, use public/get_combo_ids. For one combo, use public/get_combo_details. Expired or archivized combo names are looked up with public/get_instrument, not this method.

📖 Related Article: Options Data Collection Best Practices

Try in API console

get/public/get_combos

Request

  • Base URL
    https://test.deribit.com/api/v2
  • URL
    https://test.deribit.com/api/v2/public/get_combos
  • Auth
    none declared

Query parameters

currency'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR' | 'any' required

Currency name or "any" if don't care

The currency symbol or "any" for all.

📖 Related Article: Using the currency Parameter

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

Example response

{
  "result": [
    {
      "id": "BTC-FS-31DEC21-PERP",
      "state_timestamp": 1536569522277,
      "creation_timestamp": 1536569522277,
      "legs": [
        {
          "instrument_name": "BTC-PERPETUAL",
          "amount": -1
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 11 revisions of this API.