---
title: "GET /private/get_account_summary"
method: GET
path: "/private/get_account_summary"
tags: ["Account Management", "Private"]
---

# GET /private/get_account_summary

`GET /private/get_account_summary`

Retrieves the account summary for a specific currency. The summary includes balance, equity, available funds, initial margin, maintenance margin, and other margin-related information.

To retrieve the summary for a specific subaccount, use the `subaccount_id` parameter. When the `extended` parameter is set to `true`, additional account details such as account ID, username, email, and account type are included.

**Scope:** `account:read`

[Try in API console](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_account_summary)

## Query parameters

- `currency` 'BTC' | 'ETH' | 'STETH' | 'ETHW' | 'USDC' | 'USDT' | 'EURR' | 'SOL' | 'XRP' | 'USYC' | 'PAXG' | 'BNB' | 'USDE', required — Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`
- `subaccount_id` integer
- `extended` boolean

## Response `200`

Success response

- PrivateAccountResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` object, required
    - `total_pl` number, required — Profit and loss
    - `session_rpl` number, required — Session realized profit and loss
    - `session_upl` number, required — Session unrealized profit and loss
    - `available_funds` number, required — The account's available funds. When cross collateral is enabled, this aggregated value is calculated by converting the sum of each cross collateral currency's value to the given currency, using each cross collateral currency's index.
    - `available_withdrawal_funds` number, required — The account's available to withdrawal funds
    - `margin_balance` number — The account's margin balance. When cross collateral is enabled, this aggregated value is calculated by converting the sum of each cross collateral currency's value to the given currency, using each cross collateral currency's index.
    - `balance` number, required — The account's balance
    - `spot_reserve` number — The account's balance reserved in active spot orders
    - `additional_reserve` number — The account's balance reserved in other orders
    - `fee_balance` number — The account's fee balance (it can be used to pay for fees)
    - `fee_group` string — Fee group indicates the level of fee discounts applied to an account. Use `extended`: `true` to view this field. If the field is missing, the account is not assigned to any fee group. **📖 Related Support Article:** [Automatically applied volume based fee discounts](https://support.deribit.com/hc/en-us/articles/25944746248989-Fees#heading-11)
    - `currency` string, required — The selected currency
    - `delta_total` number, required — The sum of position deltas. **DeltaTotal = Net Transaction Delta of options + BTC Position of Futures** The DeltaTotal uses the Net Transaction Delta (or price adjusted Delta) of the options, where Net Transaction Delta = Black Scholes Delta - Mark Price of Options. This is because, from a risk perspective, we are interested in the change in Bitcoin price as the underlying changes. You should actually treat your delta as **Equity + Delta Total** if you want to have less risk for your USD PnL. ⚠️ **During the 30 minute settlement period we decay your Delta.** See [Delta decay during settlement](https://support.deribit.com/hc/en-us/articles/25944751433757-Delta-decay-during-settlement) for more details.
    - `projected_delta_total` number, required — The sum of position deltas without positions that will expire during closest expiration
    - `deposit_address` string — The deposit address for the account (if available)
    - `email` string, required — User email (available when parameter `extended` = `true`)
    - `equity` number, required — The account's current equity
    - `futures_pl` number, required — Futures profit and Loss
    - `futures_session_rpl` number, required — Futures session realized profit and Loss
    - `futures_session_upl` number, required — Futures session unrealized profit and Loss
    - `initial_margin` number, required — The account's initial margin. When cross collateral is enabled, this aggregated value is calculated by converting the sum of each cross collateral currency's value to the given currency, using each cross collateral currency's index.
    - `maintenance_margin` number, required — The maintenance margin. When cross collateral is enabled, this aggregated value is calculated by converting the sum of each cross collateral currency's value to the given currency, using each cross collateral currency's index.
    - `estimated_liquidation_ratio` number — Estimated Liquidation Ratio is returned only for users without portfolio margining enabled. Multiplying it by future position's market price returns its estimated liquidation price. When cross collateral is enabled, this aggregated value is calculated by converting the sum of each cross collateral currency's value to the given currency, using each cross collateral currency's index.
    - `system_name` string, required — System generated user nickname (available when parameter `extended` = `true`)
    - `options_delta` number, required — Options summary delta
    - `options_gamma` number, required — Options summary gamma
    - `options_pl` number, required — Options profit and Loss
    - `options_session_rpl` number, required — Options session realized profit and Loss
    - `options_session_upl` number, required — Options session unrealized profit and Loss
    - `options_theta` number, required — Options summary theta
    - `options_value` number, required — Options value
    - `options_vega` number, required — Options summary vega
    - `options_gamma_map` object, required — Map of options' gammas per index
    - `options_theta_map` object, required — Map of options' thetas per index
    - `options_vega_map` object, required — Map of options' vegas per index
    - `security_keys_enabled` boolean, required — Whether Security Key authentication is enabled (available when parameter `extended` = `true`)
    - `mmp_enabled` boolean — Whether MMP is enabled (available when parameter `extended` = `true`)
    - `projected_initial_margin` number — Projected initial margin. When cross collateral is enabled, this aggregated value is calculated by converting the sum of each cross collateral currency's value to the given currency, using each cross collateral currency's index.
    - `projected_maintenance_margin` number, required — Projected maintenance margin. When cross collateral is enabled, this aggregated value is calculated by converting the sum of each cross collateral currency's value to the given currency, using each cross collateral currency's index.
    - `username` string, required — Account name (given by user) (available when parameter `extended` = `true`)
    - `type` 'main' | 'subaccount', required — Account type (available when parameter `extended` = `true`)
    - `login_enabled` boolean — Whether account is loginable using email and password (available when parameter `extended` = `true` and account is a subaccount)
    - `id` integer, required — Account id (available when parameter `extended` = `true`)
    - `portfolio_margining_enabled` boolean — `true` when portfolio margining is enabled for user
    - `cross_collateral_enabled` boolean — When `true` cross collateral is enabled for user
    - `margin_model` string — Name of user's currently enabled margin model
    - `total_equity_usd` number — Optional (only for users using cross margin). The account's total equity in all cross collateral currencies, expressed in USD
    - `total_initial_margin_usd` number — Optional (only for users using cross margin). The account's total initial margin in all cross collateral currencies, expressed in USD
    - `total_maintenance_margin_usd` number — Optional (only for users using cross margin). The account's total maintenance margin in all cross collateral currencies, expressed in USD
    - `total_margin_balance_usd` number — Optional (only for users using cross margin). The account's total margin balance in all cross collateral currencies, expressed in USD
    - `total_delta_total_usd` number — Optional (only for users using cross margin). The account's total delta total in all cross collateral currencies, expressed in USD
    - `interuser_transfers_enabled` boolean — `true` when the inter-user transfers are enabled for user (available when parameter `extended` = `true`)
    - `referrer_id` string — Optional identifier of the referrer (of the affiliation program, and available when parameter `extended` = `true`), which link was used by this account at registration. It coincides with suffix of the affiliation link path after `/reg-`
    - `limits` ApiLimits — Returned object is described in [separate document](https://support.deribit.com/hc/en-us/articles/25944617523357-Rate-Limits).
    - `creation_timestamp` integer — Time at which the account was created (milliseconds since the Unix epoch; available when parameter `extended` = `true`)
    - `has_non_block_chain_equity` boolean — Optional field returned with value `true` when user has non block chain equity that is excluded from proof of reserve calculations
    - `self_trading_reject_mode` string — Self trading rejection behavior - `reject_taker` or `cancel_maker` (available when parameter `extended` = `true`)
    - `self_trading_extended_to_subaccounts` string — `true` if self trading rejection behavior is applied to trades between subaccounts (available when parameter `extended` = `true`)
    - `fees` object — Fee structure for all currency pairs and instrument types related to the currency (available when parameter `extended` = `true` and user has any discounts). Keys are index names (e.g., "btc_usd"), values are objects with instrument types as keys (option, perpetual, future).
    - `affiliate_promotion_fee` number — Affiliate promotion fee (if greater than 0.0)
    - `trading_products_details` object — Which trading products are enabled or can be overwritten for the account
    - `receive_notifications` boolean — Whether the account receives notifications
    - `is_direct_access_allowed` boolean — Whether Direct Access trading is enabled for the account.

---

[API](https://skmtc.net/deribit/apis/deribit-api-2.md) · [All operations](https://skmtc.net/deribit/apis/deribit-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deribit/deribit-api-2/versions/430b3f0bc67c/schema)