---
title: "GET /public/get_combos"
method: GET
path: "/public/get_combos"
tags: ["Combo Books", "Public"]
---

# GET /public/get_combos

`GET /public/get_combos`

Retrieves information about active combos for the specified currency. Returns detailed information including leg structures and combo properties.

For a list of combo IDs only, use [public/get_combo_ids](https://docs.deribit.com/api-reference/combo-books/public-get_combo_ids). For details about a specific combo, use [public/get_combo_details](https://docs.deribit.com/api-reference/combo-books/public-get_combo_details).

[Try in API console](https://test.deribit.com/api_console?method=%2Fpublic%2Fget_combos)

## Query parameters

- `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR' | 'any', required — Currency name or `"any"` if don't care

## Response `200`

Success response

- PublicGetCombosResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` Combo[], required
    - `id` string — Unique combo identifier
    - `instrument_id` integer — Instrument ID
    - `state` 'active' | 'inactive' — Combo state: `"active"`, "`inactive`"
    - `state_timestamp` integer — The timestamp (milliseconds since the Unix epoch)
    - `creation_timestamp` integer — The timestamp (milliseconds since the Unix epoch)
    - `legs` ComboLeg[]
      - `instrument_name` string — Unique instrument identifier
      - `amount` integer — Size multiplier of a leg. A negative value indicates that the trades on given leg are in opposite direction to the combo trades they originate from

---

[API](https://skmtc.net/deribit/apis/deribit-api.md) · [All operations](https://skmtc.net/deribit/apis/deribit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deribit/deribit-api/versions/78a0783dbfcc/schema)