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
Request
- Base URLhttps://test.deribit.com/api/v2
- URLhttps://test.deribit.com/api/v2/public/get_combos
- Authnone declared
Query parameters
Currency name or "any" if don't care
The currency symbol or "any" for all.
📖 Related Article: Using the currency Parameter
Response
Success response
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.