---
title: "Get Margin Account Summary"
method: POST
path: "/v1/margin/account"
tags: ["Margin Trading"]
---

# Get Margin Account Summary

`POST /v1/margin/account`

## Request

- Base URL: `https://api.gemini.com`
- URL: `https://api.gemini.com/v1/margin/account`
- Auth: API key in header `X-GEMINI-APIKEY` and API key in header `X-GEMINI-SIGNATURE` and API key in header `X-GEMINI-PAYLOAD`

Retrieves comprehensive margin account information including collateral, leverage, buying/selling power, and liquidation risk.

This endpoint provides real-time margin statistics for spot margin trading accounts, helping you monitor your account health and manage risk.
Buying power and selling power are calculated for the requested trading pair and reflect the account's current collateral, positions, orders, and margin settings. All monetary risk values in the response are denominated in USD.

### Roles
The API key you use to access this endpoint must have the Trader, Fund Manager or Auditor role assigned. See [Roles](/roles#roles) for more information.

The OAuth scope must have `balances:read` assigned to access this endpoint. See [OAuth Scopes](/authentication/oauth#oauth-scopes) for more information.

### Account Type
This endpoint is only available for margin trading accounts. Standard exchange accounts will receive an error.

## Headers

- `X-GEMINI-APIKEY` string, required
- `X-GEMINI-SIGNATURE` string, required
- `X-GEMINI-PAYLOAD` string, required
- `Content-Type` string
- `Content-Length` string
- `Cache-Control` string

## Request body

- object
  - `request` string, required: The literal string "/v1/margin/account"
  - `nonce` union, required: The nonce, as described in [Private API Invocation](/authentication/api-key#private-api-invocation)
    - union: timestamp
      - string: Gemini strongly recommends using milliseconds instead of seconds for timestamps. | Timestamp format | Example | Supported request type | |-----------------------|-----------------------|------------------------| | string (seconds) | `1495127793` | `POST` only | | string (milliseconds) | `1495127793000` | `POST` only |
      - integer: Gemini strongly recommends using milliseconds instead of seconds for timestamps. | Timestamp format | Example | Supported request type | |-----------------------------|---------------------------|------------------------| | whole number (seconds) | `1495127793` | `GET`, `POST` | | whole number (milliseconds) | `1495127793000` | `GET`, `POST` |
    - integer
  - `symbol` string, required: The trading pair for which to calculate pair-specific buying and selling power (for example, "btcusd").
  - `account` string: Required for Master API keys as described in [Private API Invocation](/authentication/api-key#private-api-invocation). The name of the account within the subaccount group.

## Response `200`

Margin account summary with risk statistics

- MarginAccountSummary
  - `marginAssetValue` MoneyAmount, required
    - `currency` string, required: The currency code (e.g., "USD", "BTC", "ETH")
    - `value` string, decimal, required: The amount in the specified currency
  - `availableCollateral` MoneyAmount, required
    - `currency` string, required: The currency code (e.g., "USD", "BTC", "ETH")
    - `value` string, decimal, required: The amount in the specified currency
  - `notionalValue` MoneyAmount, required
    - `currency` string, required: The currency code (e.g., "USD", "BTC", "ETH")
    - `value` string, decimal, required: The amount in the specified currency
  - `totalBorrowed` MoneyAmount, required
    - `currency` string, required: The currency code (e.g., "USD", "BTC", "ETH")
    - `value` string, decimal, required: The amount in the specified currency
  - `leverage` string, decimal, required: The current leverage ratio (notionalValue / marginAssetValue)
  - `buyingPower` MoneyAmount, required
    - `currency` string, required: The currency code (e.g., "USD", "BTC", "ETH")
    - `value` string, decimal, required: The amount in the specified currency
  - `sellingPower` MoneyAmount, required
    - `currency` string, required: The currency code (e.g., "USD", "BTC", "ETH")
    - `value` string, decimal, required: The amount in the specified currency
  - `liquidationRisk` LiquidationRisk
    - `lossPercentage` string, decimal, required: The percentage loss from current value that would trigger liquidation, formatted as decimal (e.g., "0.1550" = 15.50%)
    - `liquidationPrice` MoneyAmount
      - `currency` string, required: The currency code (e.g., "USD", "BTC", "ETH")
      - `value` string, decimal, required: The amount in the specified currency
  - `interestRate` InterestRateInfo
    - `rate` string, decimal, required: The interest rate as a decimal string
    - `interval` 'hour', required: The time interval for the rate (currently only "hour" is supported)
  - `reservedBuyOrders` MoneyAmount, required
    - `currency` string, required: The currency code (e.g., "USD", "BTC", "ETH")
    - `value` string, decimal, required: The amount in the specified currency
  - `reservedSellOrders` MoneyAmount, required
    - `currency` string, required: The currency code (e.g., "USD", "BTC", "ETH")
    - `value` string, decimal, required: The amount in the specified currency

## Other responses

- `400`: Bad request - malformed request or invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `403`: ApiKey fails IP Filtering Check
- `404`: Resource not found
- `429`: Too many requests - you have exceeded the rate limit
- `500`: Internal server error

---

[API](https://skmtc.dev/gemini/apis/rest-api.md) - [All operations](https://skmtc.dev/gemini/apis/rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gemini/apis/rest-api/revisions/24979792d748?raw)