private/get_margins

Calculates margin requirements for a hypothetical order on a given instrument. Returns initial margin and maintenance margin for the specified instrument, quantity, and price.

This method is useful for estimating margin requirements before placing an order, helping to ensure sufficient funds are available and understanding the margin impact of potential trades.

Scope: trade:read

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/get_margins \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "private/get_margins",
  "params": {
    "instrument_name": "BTC-PERPETUAL",
    "amount": 10000,
    "price": 3725
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 7,
  "result": {
    "sell": 0,
    "min_price": 3684.8,
    "max_price": 3759.24,
    "buy": 0.0219949
  }
}

Query Parameters

instrument_name · string · required

Instrument name Unique instrument identifier

Example:

"BTC-PERPETUAL"

amount · number · required

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.

price · number · required

Price

Example:

3725

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. buy · number · required

Margin when buying

Example:

0.01681367

result. sell · number · required

Margin when selling

Example:

0.01680479

result. min_price · number · required

The minimum price for the future. Any sell orders you submit lower than this price will be clamped to this minimum.

result. max_price · number · required

The maximum price for the future. Any buy orders you submit higher than this price, will be clamped to this maximum.

id · integer

The id that was sent in the request