Skip to main content
PATCH
PATCH /v2/trade/perps/leverage: Leverage and Margin
Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use request signing examples.

Set leverage

Leverage is set per instrument, for the whole account. It is not an order field. Scope trade.perps; Idempotency-Key is honoured.

Body

integer
required
The venue instrument id.
integer
required
1 to 100, subject to your integration’s cap and the venue’s risk tiers.
boolean
required
true for cross margin, false for isolated.
The margin mode cannot change while a position or open orders exist on the instrument.

Errors

Every Perps code and its retry rule: Errors.

Example

Add or remove isolated margin

Scope trade.perps; Idempotency-Key is honoured.

Body

integer
required
The venue instrument id of the isolated position.
string
required
pUSD to add (positive) or remove (negative) from an isolated position. Signed decimal string.
When Bravado halts perps, removing isolated margin (a negative delta) answers 409 PERPS_HALTED.

Example