---
title: "Choose leverage for a position."
method: POST
path: "/position/leverage"
tags: ["Position"]
---

# Choose leverage for a position.

`POST /position/leverage`

Users can choose an isolated leverage. This will automatically enable isolated margin.

## Response `200`

Request was successful

- Position — Summary of Open and Closed Positions
  - `account` integer, required
  - `symbol` string, required
  - `currency` string
  - `underlying` string
  - `quoteCurrency` string
  - `commission` number, double
  - `initMarginReq` number, double
  - `maintMarginReq` number, double
  - `riskLimit` integer
  - `leverage` number, double
  - `crossMargin` boolean
  - `deleveragePercentile` number, double
  - `rebalancedPnl` integer
  - `prevRealisedPnl` integer
  - `prevUnrealisedPnl` integer
  - `openingQty` integer
  - `openOrderBuyQty` integer
  - `openOrderBuyCost` integer
  - `openOrderBuyPremium` integer
  - `openOrderSellQty` integer
  - `openOrderSellCost` integer
  - `openOrderSellPremium` integer
  - `currentQty` integer
  - `currentCost` integer
  - `currentComm` integer
  - `realisedCost` integer
  - `unrealisedCost` integer
  - `grossOpenPremium` integer
  - `isOpen` boolean
  - `markPrice` number, double
  - `markValue` integer
  - `riskValue` integer
  - `homeNotional` number, double
  - `foreignNotional` number, double
  - `posState` string
  - `posCost` integer
  - `posCross` integer
  - `posComm` integer
  - `posLoss` integer
  - `posMargin` integer
  - `posMaint` integer
  - `initMargin` integer
  - `maintMargin` integer
  - `realisedPnl` integer
  - `unrealisedPnl` integer
  - `unrealisedPnlPcnt` number, double
  - `unrealisedRoePcnt` number, double
  - `avgCostPrice` number, double
  - `avgEntryPrice` number, double
  - `breakEvenPrice` number, double
  - `marginCallPrice` number, double
  - `liquidationPrice` number, double
  - `bankruptPrice` number, double
  - `timestamp` string, date-time

## Other responses

- `400` — Parameter Error
- `401` — Unauthorized
- `403` — Access Denied
- `404` — Not Found

## Changes

- **2019-12-18** `fd2de3a82a03` — 1 info
  - added the non-success response with the status `403`
- **2018-05-30** `0c1c991454e3` — 1 info
  - removed the non-success response with the status `403`

[Change history](https://skmtc.dev/bitmex/apis/bitmex-api/changes/position/leverage/post.md)

---

[API](https://skmtc.dev/bitmex/apis/bitmex-api.md) · [All operations](https://skmtc.dev/bitmex/apis/bitmex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitmex/bitmex-api/revisions/04c6a16ffd27/schema)