---
title: "Update leverage"
method: POST
path: "/v2/leverage"
tags: ["Trading"]
---

# Update leverage

`POST /v2/leverage`

Update the leverage for a specific symbol.

**Note:** This affects new positions only. Existing positions are not modified.

## Request body

- LeverageRequest
  - `symbol` string, required — Trading pair symbol
  - `leverage` integer, required — New leverage value
  - `vault_id` string — Optional vault ID. When provided, updates leverage for the vault account. Caller must be the vault leader.
  - `sub_account_id` string, uuid — Optional active subaccount whose leverage should be updated. Mutually exclusive with vault_id.

## Response `200`

Leverage updated

- LeverageResponse
  - `leverage` integer — New leverage value
  - `maxNotionalValue` string — Maximum notional value at this leverage
  - `symbol` string — Trading pair symbol
  - `request_id` string — Request correlation ID

## Other responses

- `400` — Invalid query parameter
- `401` — Authentication is missing, invalid, or does not own the selected subaccount
- `404` — Account, vault, or requested resource not found

---

[API](https://skmtc.net/strikefinance/apis/strike-finance-staking-api.md) · [All operations](https://skmtc.net/strikefinance/apis/strike-finance-staking-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/strikefinance/strike-finance-staking-api/revisions/6b7d8bd51050/schema)