private/get_subaccounts_details

Retrieves position details for all subaccounts for a specific currency. Returns positions aggregated across all subaccounts, including size, average entry price, mark price, and P&L information.

Optionally include open orders for each subaccount by setting the with_open_orders parameter to true.

📖 Related Article: Managing Subaccounts

Scope: account:read

Try in API console

cURL

cURL

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

import requests

url = "https://test.deribit.com/api/v2/private/get_subaccounts_details"

payload = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "private/get_subaccounts_details",
    "params": { "currency": "BTC" }
}
headers = {"Content-Type": "application/json"}

response = requests.get(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'private/get_subaccounts_details',
    params: {currency: 'BTC'}
  })
};

fetch('https://test.deribit.com/api/v2/private/get_subaccounts_details', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://test.deribit.com/api/v2/private/get_subaccounts_details",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '2.0',
    'id' => 1,
    'method' => 'private/get_subaccounts_details',
    'params' => [
        'currency' => 'BTC'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://test.deribit.com/api/v2/private/get_subaccounts_details"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"private/get_subaccounts_details\",\n  \"params\": {\n    \"currency\": \"BTC\"\n  }\n}")

	req, _ := http.NewRequest("GET", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://test.deribit.com/api/v2/private/get_subaccounts_details")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"private/get_subaccounts_details\",\n  \"params\": {\n    \"currency\": \"BTC\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://test.deribit.com/api/v2/private/get_subaccounts_details")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"private/get_subaccounts_details\",\n  \"params\": {\n    \"currency\": \"BTC\"\n  }\n}"

response = http.request(request)
puts response.read_body

200

{
  "jsonrpc": "2.0",
  "result": [
    {
      "uid": 3,
      "positions": [
        {
          "total_profit_loss": -0.000118183,
          "size_currency": 0.004152776,
          "size": 200,
          "settlement_price": 48150.36,
          "realized_profit_loss": -8.79e-7,
          "realized_funding": -8.8e-7,
          "open_orders_margin": 0,
          "mark_price": 48160.55,
          "maintenance_margin": 0.000089286,
          "leverage": 34,
          "kind": "future",
          "instrument_name": "BTC-PERPETUAL",
          "initial_margin": 0.000122508,
          "index_price": 47897.12,
          "floating_profit_loss": -0.00003451,
          "estimated_liquidation_price": 2.33,
          "direction": "buy",
          "delta": 0.004152776,
          "average_price": 49571.3
        }
      ]
    },
    {
      "uid": 10,
      "positions": [
        {
          "total_profit_loss": 0.000037333,
          "size_currency": -0.001308984,
          "size": -60,
          "settlement_price": 47886.98,
          "realized_profit_loss": 0,
          "open_orders_margin": 0,
          "mark_price": 45837.07,
          "maintenance_margin": 0.000028143,
          "leverage": 34,
          "kind": "future",
          "instrument_name": "BTC-3SEP21",
          "initial_margin": 0.000038615,
          "index_price": 47897.12,
          "floating_profit_loss": 0.000037333,
          "estimated_liquidation_price": null,
          "direction": "sell",
          "delta": -0.001308984,
          "average_price": 47182.76
        }
      ]
    }
  ]
}

{
  "jsonrpc": "2.0",
  "message": "<string>",
  "error": 123,
  "id": 123
}

Query Parameters

currency · enum<string> · required

The currency symbol Currency, i.e "BTC", "ETH", "USDC"

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

with_open_orders · boolean

Optional parameter to ask for open orders list, default: false

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. uid · integer · required

Account/Subaccount identifier

result. positions · object[] · required

Hide child attributes

result.positions. instrument_name · string · required

Unique instrument identifier

Example:

"BTC-PERPETUAL"

result.positions. kind · enum<string> · required

Instrument kind: "future", "option", "spot", "future_combo", "option_combo"

Available options: future, option, spot, future_combo, option_combo

result.positions. average_price · number · required

Average price of trades that built this position

result.positions. direction · enum<string> · required

Direction: buy, sell or zero

Available options: buy, sell, zero

result.positions. mark_price · number · required

Current mark price for position's instrument

result.positions. delta · number · required

Delta parameter

result.positions. index_price · number · required

Current index price

result.positions. initial_margin · number · required

Initial margin

result.positions. maintenance_margin · number · required

Maintenance margin

result.positions. settlement_price · number · required

Optional (not added for spot). Last settlement price for position's instrument 0 if instrument wasn't settled yet

result.positions. total_profit_loss · number · required

Profit or loss from position

result.positions. floating_profit_loss · number · required

Floating profit or loss

result.positions. realized_profit_loss · number · required

Realized profit or loss

result.positions. size · number · required

Position size for futures size in quote currency (e.g. USD), for options size is in base currency (e.g. BTC)

result.positions. gamma · number

Only for options, Gamma parameter

result.positions. vega · number

Only for options, Vega parameter

result.positions. theta · number

Only for options, Theta parameter

result.positions. size_currency · number

Only for futures, position size in base currency

result.positions. average_price_usd · number

Only for options, average price in USD

result.positions. floating_profit_loss_usd · number

Only for options, floating profit or loss in USD

result.positions. leverage · integer

Current available leverage for future position

result.positions. realized_funding · number

Realized Funding in current session included in session realized profit or loss, only for positions of perpetual instruments

result.positions. interest_value · number

Value used to calculate realized_funding (perpetual only)

result. open_orders · object[]

Hide child attributes

result.open_orders. order_id · string · required

Unique order identifier

Example:

"ETH-100234"

result.open_orders. order_state · enum<string> · required

Order state: "open", "filled", "rejected", "cancelled", "untriggered"

Available options: open, filled, rejected, cancelled, untriggered, triggered

result.open_orders. order_type · enum<string> · required

Order type: "limit", "market", "stop_limit", "stop_market", "take_limit", "take_market", "trailing_stop"

Available options: market, limit, stop_market, stop_limit, take_market, take_limit, trailing_stop

result.open_orders. time_in_force · enum<string> · required

Order time in force: "good_til_cancelled", "good_til_day", "fill_or_kill" or "immediate_or_cancel"

Available options: good_til_cancelled, good_til_day, fill_or_kill, immediate_or_cancel

result.open_orders. instrument_name · string · required

Unique instrument identifier

Example:

"BTC-PERPETUAL"

result.open_orders. creation_timestamp · integer · required

The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

result.open_orders. last_update_timestamp · integer · required

The timestamp (milliseconds since the Unix epoch)

Example:

1536569522277

result.open_orders. direction · enum<string> · required

Direction: buy, or sell

Available options: buy, sell

result.open_orders. price · number enum<string> · required

Price in base currency or "market_price" in case of open trigger market orders

result.open_orders. label · string · required

User defined label (up to 64 characters)

result.open_orders. post_only · boolean · required

true for post-only orders only

result.open_orders. api · boolean · required

true if created with API

result.open_orders. original_order_type · enum<string>

Original order type. Optional field

Available options: market, market_limit

result.open_orders. is_rebalance · boolean

Optional (only for spot). true if order was automatically created during cross-collateral balance restoration

result.open_orders. is_liquidation · boolean

Optional (not added for spot). true if order was automatically created during liquidation

result.open_orders. reject_post_only · boolean

true if order has reject_post_only flag (field is present only when post_only is true)

result.open_orders. reduce_only · boolean

Optional (not added for spot). 'true for reduce-only orders only'

result.open_orders. web · boolean

true if created via Deribit frontend (optional)

result.open_orders. mobile · boolean

Optional field with value true added only when created with Mobile Application

result.open_orders. refresh_amount · number

The initial display amount of iceberg order. Iceberg order display amount will be refreshed to that value after match consuming actual display amount. Absent for other types of orders

result.open_orders. display_amount · number

The actual display amount of iceberg order. Absent for other types of orders.

result.open_orders. 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.

result.open_orders. contracts · number

It represents the order size in contract units. (Optional, may be absent in historical data).

result.open_orders. filled_amount · number

Filled amount of the order. For perpetual and futures the filled_amount is in USD units, for options - in units or corresponding cryptocurrency contracts, e.g., BTC or ETH.

result.open_orders. average_price · number

Average fill price of the order

result.open_orders. advanced · enum<string>

advanced type: "usd" or "implv" (Only for options; field is omitted if not applicable).

Available options: usd, implv

result.open_orders. implv · number

Implied volatility in percent. (Only if advanced="implv")

result.open_orders. usd · number

Option price in USD (Only if advanced="usd")

result.open_orders. triggered · boolean

Whether the trigger order has been triggered

result.open_orders. trigger · enum<string>

Trigger type (only for trigger orders). Allowed values: "index_price", "mark_price", "last_price".

Available options: index_price, mark_price, last_price

result.open_orders. trigger_price · number

Trigger price (Only for future trigger orders)

result.open_orders. trigger_offset · number

The maximum deviation from the price peak beyond which the order will be triggered (Only for trailing trigger orders)

result.open_orders. trigger_reference_price · number

The price of the given trigger at the time when the order was placed (Only for trailing trigger orders)

result.open_orders. block_trade · boolean

true if order made from block_trade trade, added only in that case.

Example:

true

result.open_orders. mmp · boolean

true if the order is a MMP order, otherwise false.

result.open_orders. risk_reducing · boolean

true if the order is marked by the platform as a risk reducing order (can apply only to orders placed by PM users), otherwise false.

result.open_orders. replaced · boolean

true if the order was edited (by user or - in case of advanced options orders - by pricing engine), otherwise false.

result.open_orders. auto_replaced · boolean

Options, advanced orders only - true if last modification of the order was performed by the pricing engine, otherwise false.

result.open_orders. quote · boolean

If order is a quote. Present only if true.

result.open_orders. mmp_group · string

Name of the MMP group supplied in the private/mass_quote request. Only present for quote orders.

result.open_orders. quote_set_id · string

Identifier of the QuoteSet supplied in the private/mass_quote request. Only present for quote orders.

result.open_orders. quote_id · string

The same QuoteID as supplied in the private/mass_quote request. Only present for quote orders.

result.open_orders. trigger_order_id · string

Id of the trigger order that created the order (Only for orders that were created by triggered orders).

Example:

"SLIB-370"

result.open_orders. combo_order_id · string

Id of the combo order that created this order (only present for orders that were created as legs of a combo order).

Example:

"103148386169"

result.open_orders. app_name · string

The name of the application that placed the order on behalf of the user (optional).

Example:

"Example Application"

result.open_orders. mmp_cancelled · boolean

true if order was cancelled by mmp trigger (optional)

Example:

true

result.open_orders. cancel_reason · enum<string>

Enumerated reason behind cancel "user_request", "autoliquidation", "cancel_on_disconnect", "risk_mitigation", "pme_risk_reduction" (portfolio margining risk reduction), "pme_account_locked" (portfolio margining account locked per currency), "position_locked", "mmp_trigger" (market maker protection), "mmp_config_curtailment" (market maker configured quantity decreased), "edit_post_only_reject" (cancelled on edit because of reject_post_only setting), "oco_other_closed" (the oco order linked to this order was closed), "oto_primary_closed" (the oto primary order that was going to trigger this order was cancelled), "settlement" (closed because of a settlement)

Available options: user_request, autoliquidation, cancel_on_disconnect, risk_mitigation, pme_risk_reduction, pme_account_locked, position_locked, mmp_trigger, mmp_config_curtailment, edit_post_only_reject, oco_other_closed, oto_primary_closed, settlement

result.open_orders. oto_order_ids · string[]

The Ids of the orders that will be triggered if the order is filled

Order Id

result.open_orders. trigger_fill_condition · enum<string>

The fill condition of the linked order (Only for linked order types), default: `first_hit`.

• `"first_hit"` - any execution of the primary order will fully cancel/place all secondary orders.
• `"complete_fill"` - a complete execution (meaning the primary order no longer exists) will cancel/place the secondary orders.
• `"incremental"` - any fill of the primary order will cause proportional partial cancellation/placement of the secondary order. The amount that will be subtracted/added to the secondary order will be rounded down to the contract size.

Available options: first_hit, complete_fill, incremental

result.open_orders. oco_ref · string

Unique reference that identifies a one_cancels_others (OCO) pair.

result.open_orders. primary_order_id · string

ID of the order that triggered this order.

Example:

"ETH-100234"

result.open_orders. is_secondary_oto · boolean

true if the order is an order that can be triggered by another order, otherwise not present.

result.open_orders. is_primary_otoco · boolean

true if the order is an order that can trigger an OCO pair, otherwise not present.

id · integer

The id that was sent in the request