---
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`

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.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)