private/get_leg_prices

Returns individual leg prices for a given combo structure based on an aggregated price of the strategy and the mark prices of the individual legs.

Note: Leg prices change dynamically with mark price fluctuations, and the algorithm is calibrated only for conventional option structures and future spreads. This method supports both inverse strategies and known linear structures within a single currency pair.

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/get_leg_prices \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "private/get_leg_prices",
  "params": {
    "price": 0.6,
    "legs": [
      {
        "instrument_name": "BTC-1NOV24-67000-C",
        "direction": "buy",
        "amount": 2
      },
      {
        "instrument_name": "BTC-1NOV24-66000-C",
        "direction": "sell",
        "amount": 2
      }
    ]
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "legs": [
      {
        "ratio": 1,
        "instrument_name": "BTC-1NOV24-67000-C",
        "price": 0.6001,
        "direction": "buy"
      },
      {
        "ratio": 1,
        "instrument_name": "BTC-1NOV24-66000-C",
        "price": 0.0001,
        "direction": "sell"
      }
    ],
    "amount": 2
  }
}

Query Parameters

legs · object[] · required

List of legs for which the prices will be calculated

Hide child attributes

legs. instrument_name · string

Instrument name

Example:

"BTC-PERPETUAL"

legs. amount · number

It represents the requested trade size. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.

legs. direction · enum<string>

Direction of selected leg

Available options: buy, sell

price · number · required

Price for the whole leg structure

Response

200 - application/json

Success response

jsonrpc · enum<string> · required

The JSON-RPC version (2.0)

Available options: 2.0

result · object · required

Hide child attributes

result. legs · object[]

Hide child attributes

result.legs. ratio · integer

Ratio of amount between legs

result.legs. instrument_name · string

Unique instrument identifier

Example:

"BTC-PERPETUAL"

result.legs. direction · enum<string>

Direction: buy, or sell

Available options: buy, sell

result.legs. price · number

Price for a leg

result. amount · number

This value multiplied by the ratio of a leg gives trade size on that leg.

id · integer

The id that was sent in the request