---
title: "GET /private/create_combo"
method: GET
path: "/private/create_combo"
tags: ["Combo Books", "Matching Engine", "Private"]
---

# GET /private/create_combo

`GET /private/create_combo`

Verifies and creates a combo book or returns an existing combo matching the given trades. Combos allow trading on multiple instruments (futures and options) simultaneously as a single strategy.

If a combo matching the provided trades already exists, this method returns the existing combo. Otherwise, it creates a new combo book with the specified leg structure.

**Scope:** `trade:read_write`

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

## Query parameters

- `trades` object[], required
  - `instrument_name` string — Unique instrument identifier
  - `amount` number — It represents the requested order size. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.
  - `direction` 'buy' | 'sell' — Direction: `buy`, or `sell`

## Response `200`

Success response

- PrivateCreateComboResponse
  - `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/revisions/78a0783dbfcc/schema)