private/get_order_margin_by_ids

Retrieves the initial margin requirements for one or more orders identified by their order IDs. Initial margin is the amount of funds required to open a position with these orders.

This method is useful for calculating margin requirements before placing orders, helping to ensure sufficient funds are available.

Scope: trade:read

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/get_order_margin_by_ids \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 5625,
  "method": "private/get_order_margin_by_ids",
  "params": {
    "ids": [
      "ETH-349280",
      "ETH-349279",
      "ETH-349278"
    ]
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 5625,
  "result": [
    {
      "order_id": "ETH-349278",
      "initial_margin": 0.00091156,
      "initial_margin_currency": "ETH"
    },
    {
      "order_id": "ETH-349279",
      "initial_margin": 0,
      "initial_margin_currency": "ETH"
    },
    {
      "order_id": "ETH-349280",
      "initial_margin": 0,
      "initial_margin_currency": "ETH"
    }
  ]
}

Query Parameters

ids · string[] · required

Ids of orders

Example:

["ETH-349280", "ETH-349279", "ETH-349278"]

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. order_id · string · required

Unique order identifier

Example:

"ETH-100234"

result. initial_margin · number · required

Initial margin of order

result. initial_margin_currency · string

Currency of initial margin

id · integer

The id that was sent in the request