Combo Books
Public

Retrieves a live combo by combo_id: legs, combo state, state_timestamp, creation_timestamp, and instrument_id. This is not the full instrument spec — use public/get_instrument with the same ID for tick size, commissions, and book state.

Looks up the live combo table only. Unknown IDs fail with combo not found; malformed IDs fail with wrong format. Expired or archivized combos that public/get_combo_ids no longer lists can still be loaded as instruments via public/get_instrument.

Use public/get_combo_ids to list live combo IDs.

📖 Related Article: Options Data Collection Best Practices

Try in API console

get/public/get_combo_details

Request

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

Query parameters

combo_idstring required

Unique combo identifier

Example:BTC-FS-31DEC21-PERP

Combo ID (same string as the combo instrument name, for example BTC-FS-31DEC21-PERP). Malformed values fail with wrong format.

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.