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

# Get Account Margin

`POST /v1/margin`

## Request

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

### Roles
The API key you use to access this endpoint must have the Trader or Auditor role assigned. See <a href="/roles#roles">Roles</a> for more information.

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

## 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 API endpoint path
  - `nonce` union, required: 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` |
  - `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. Specifies the account on which you intend to place the order. Only available for exchange accounts.
  - `symbol` string, required: Trading pair symbol. See [symbols and minimums](/market-data/symbols-and-minimums)

## Response `200`

JSON object

- MarginResponse
  - `margin_assets_value` string, decimal: The $ equivalent value of all the assets available in the current trading account that can contribute to funding a derivatives position.
  - `initial_margin` string, decimal: The $ amount that is being required by the accounts current positions and open orders.
  - `available_margin` string, decimal: The difference between the `margin_assets_value` and `initial_margin`.
  - `margin_maintenance_limit` string, decimal: The minimum amount of `margin_assets_value` required before the account is moved to liquidation status.
  - `leverage` string, decimal: The ratio of Notional Value to Margin Assets Value.
  - `notional_value` string, decimal: The $ value of the current position.
  - `estimated_liquidation_price` string, decimal: The estimated price for the asset at which liquidation would occur.
  - `initial_margin_positions` string, decimal: The contribution to `initial_margin` from open positions.
  - `reserved_margin` string, decimal: The contribution to `initial_margin` from open orders.
  - `reserved_margin_buys` string, decimal: The contribution to `initial_margin` from open BUY orders.
  - `reserved_margin_sells` string, decimal: The contribution to `initial_margin` from open SELL orders.
  - `buying_power` string, decimal: The amount of that product the account could purchase based on current `initial_margin` and `margin_assets_value`.
  - `selling_power` string, decimal: The amount of that product the account could sell based on current `initial_margin` and `margin_assets_value`.

---

[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)