Set leverage
Sets or updates the leverage preference for a portfolio on a specific market.
Endpoint
PUT /api/v1/leverage
Authentication
Device-key cookie or X-API-KEY header.
Returns
200 OKwithLeverageSettingResponsereflecting the stored value.400 Bad Requestif the market string is invalid or leverage is out of range.404 Not Foundif the portfolio does not exist.
Authorizations
Base64-encoded API key issued by POST /api/v1/api-keys.
Body
Request for setting leverage on a market.
10
"BTC-PERP"
A unique identifier for a portfolio within a subaccount.
x >= 0A unique identifier for a subaccount within an account.
x >= 0Response
Stored leverage setting
Response for a leverage setting.
A system-generated unique identifier for an account.
x >= 0A unique identifier for a portfolio within a subaccount.
x >= 0A unique identifier for a subaccount within an account.
x >= 0Leverage multiplier applied to positions in this market.
10
The market symbol the setting applies to (e.g. BTC-PERP).
"BTC-PERP"