private/change_margin_model

Changes the margin model for the authenticated account or a specified subaccount. Margin models determine how margin requirements are calculated (e.g., Standard Margin vs. Portfolio Margin).

Changing the margin model may affect margin requirements, available funds, and trading capabilities. Use the dry_run parameter to preview the impact of the change before applying it.

📖 Related Article: Margin types and usage

Scope: account:read_write

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/change_margin_model \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "private/change_margin_model",
  "params": {
    "user_id": 3,
    "margin_model": "cross_pm"
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "old_state": {
        "maintenance_margin_rate": 0,
        "initial_margin_rate": 0,
        "available_balance": 0
      },
      "new_state": {
        "maintenance_margin_rate": 0,
        "initial_margin_rate": 0,
        "available_balance": 0
      },
      "currency": "eth"
    },
    {
      "old_state": {
        "maintenance_margin_rate": 0.02862727,
        "initial_margin_rate": 0.45407615,
        "available_balance": 0.553590509
      },
      "new_state": {
        "maintenance_margin_rate": 0.02710204,
        "initial_margin_rate": 0.03252245,
        "available_balance": 0.98106428
      },
      "currency": "btc"
    }
  ]
}

Query Parameters

user_id · integer

Id of a (sub)account - by default current user id is used

Example:

1

margin_model · enum<string> · required

Margin model

Available options: cross_pm, cross_sm, segregated_pm, segregated_sm

dry_run · boolean

If true request returns the result without switching the margining model. Default: false

Example:

true

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. old_state · object · required

Represents portfolio state before change

Hide child attributes

result.old_state. maintenance_margin_rate · number · required

Maintenance margin rate before change

result.old_state. initial_margin_rate · number · required

Initial margin rate before change

result.old_state. available_balance · number · required

Available balance before change

result. new_state · object · required

Represents portfolio state after change

Hide child attributes

result.new_state. maintenance_margin_rate · number · required

Maintenance margin rate after change

result.new_state. initial_margin_rate · number · required

Initial margin rate after change

result.new_state. available_balance · number · required

Available balance after change

result. currency · enum<string> · required

Currency, i.e "BTC", "ETH", "USDC"

Available options: BTC, ETH, USDC, USDT, EURR

id · integer

The id that was sent in the request