---
title: "Update Leverage"
method: PATCH
path: "/v1/trade/leverage"
---

# Update Leverage

`PATCH /v1/trade/leverage`

Update leverage for an instrument.
Requires proxy signature, see [proxy signing](/http/signing#2-proxy-signing).

## Request body

- LeverageRequest
  - `op` OpUpdateLeverage, required
    - `type` 'updateLeverage', required
    - `args` object, required
      - `iid` integer, required — Instrument ID
      - `lev` integer, required — Leverage
      - `cross` boolean, required — Whether to use cross margin mode
  - `sig` string, required — Signature in hex format
  - `salt` integer, required — Salt
  - `ts` integer, required — Request timestamp. Unix milliseconds for most operations; Unix seconds for withdrawals (must match the on-chain EIP-712 struct verified against block.timestamp).

## Response `200`

The instrument's effective leverage configuration after the update.

- LeverageResponse — The instrument's effective leverage configuration after the update.
  - `status` 'ok', required
  - `instrument_id` integer, required — Instrument ID
  - `leverage` integer, required — Leverage
  - `cross` boolean, required — Whether to use cross margin mode

## Other responses

- `400` — Bad request — the request was malformed or failed validation (bad query parameters, unparseable body, invalid signature, or a domain pre-check). The `error` field is a human-readable validation detail.
- `422` — Unprocessable Entity — the request was well-formed but a domain rule rejected it on its merits (insufficient balance, invalid leverage, proxy already exists, …). The body is the discriminated rejection (`status: err`) with the engine error identifier in `error`.
- `429` — Too Many Requests. `error` distinguishes the limit that was hit: `ip_rate_limited` (per-IP token bucket), `action_rate_limited` (per-account action rate), or `open_orders_limit` (resting open-order cap).
- `500` — Internal server error. `error` is `internal_error`.

---

[API](https://skmtc.net/polymarket/apis/polymarket-perps-http-api.md) · [All operations](https://skmtc.net/polymarket/apis/polymarket-perps-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polymarket/polymarket-perps-http-api/revisions/e17c4709273e/schema)