---
title: "Get margin risk settings"
method: GET
path: "/api/prime/trading/v1/accounts/{accountId}/margin/risksettings"
tags: ["Margin"]
---

# Get margin risk settings

`GET /api/prime/trading/v1/accounts/{accountId}/margin/risksettings`

## Request

- Base URL: `https://developers.bitgo.com`
- URL: `https://developers.bitgo.com/api/prime/trading/v1/accounts/{accountId}/margin/risksettings`
- Auth: none declared

Returns the margin risk settings for the specified account.

## Path parameters

- `accountId` string, required

## Response `200`

Margin risk settings

- object
  - `totalShortPositionLimit` object: Quantity representing the total NOP limit across all currencies. It sets a limit that is compared to the total short position across all currencies (eg. 1000000). Currency represents the currency that the quantity is valued in (eg. USD)
    - `quantity` string, decimal, required: The specified quantity.
    - `currency` string, required: The specified quantity currency.
  - `marginCallPercentage` string: Number representing the percentage at which a margin call will be initiated if the margin percentage falls below this number. It is in decimal form (eg. 0.8 to mean 80%)
  - `liquidationThresholdPercentage` string: Number representing the liquidation threshold percentage at which positions will be automatically liquidated if the margin utilization exceeds this level. It is in decimal form (eg. 1.2 to mean 120%)
  - `marginRequirementPercentage` string: Number representing the margin requirement percentage which is used with the NOP to determine the margin required. It is in decimal form (eg.0.2 for 20%)
  - `minimumTransferredCollateral` object: Quantity representing the minimum transferred collateral value required for margin trading. Currency represents the currency that the quantity is valued in (eg. USD)
    - `quantity` string, decimal, required: The specified quantity.
    - `currency` string, required: The specified quantity currency.

## Other responses

- `401`: Unauthorized - Invalid or missing authentication
- `403`: Forbidden - Insufficient permissions
- `500`: Internal Server Error

---

[API](https://skmtc.dev/bitgo/apis/bitgo-api.md) - [All operations](https://skmtc.dev/bitgo/apis/bitgo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bitgo/apis/bitgo-api/revisions/6b6e050a7f84?raw)