---
title: "Change Collateral Account Leverage"
method: POST
path: "/api/v4/collateral-account/leverage"
tags: ["Collateral Trading"]
---

# Change Collateral Account Leverage

`POST /api/v4/collateral-account/leverage`

The endpoint changes the leverage level for the [collateral](/glossary#balance-collateral) trading account. Leverage determines the ratio of borrowed funds to collateral and directly affects margin requirements and liquidation thresholds. Accepted values: `1`, `2`, `3`, `5`, `10`, `20`, `50`, `100`.

Each leverage level has a corresponding bracket defining the maximum position size for the tier. When a position exceeds the bracket limit, the system applies higher tiers with progressively lower leverage. Query market-specific brackets via `GET /api/v4/public/futures`.

<Warning>
Rate limit: 1000 requests/10 sec.
</Warning>

<Note>
A market's `max_leverage` field (from `GET /api/v4/public/futures`) may be lower than `100`. Setting leverage above a market's maximum results in an error.
</Note>

<Warning>
Changing leverage affects **all open positions** across margin and futures trading. Decreasing leverage increases margin requirements — if available funds are insufficient to support the new level, the request returns an error.
</Warning>

<Accordion title="Error Codes">
  - `30` - invalid `leverage` value (out of range, non-integer, or wrong type). Setting leverage above a market's `max_leverage` also surfaces here as an out-of-range value
  - `17` - the requested leverage is valid but available balance is insufficient to support it
  - `113` - leverage cannot be changed while open positions or orders exist
</Accordion>

## Request body

- object
  - `leverage` integer, required — Target leverage level. Accepted values: `1`, `2`, `3`, `5`, `10`, `20`, `50`, `100`. The effective maximum depends on the market's `max_leverage`.
  - `request` string, required
  - `nonce` integer, required

## Response `200`

Successful response - leverage changed

- object
  - `leverage` integer — Active leverage level for the collateral account after the update, from `1` (no leverage) to `100`

## Other responses

- `422` — Inner validation failed
- `503` — Service temporarily unavailable

---

[API](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4.md) · [All operations](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whitebit/whitebit-private-http-api-v4/revisions/76c9def9942f/schema)