Portfolios

Set leverage

Update the leverage for a specific market position. The new leverage must be within the allowed range for the market and your current position size.

Requires authentication.

POST
/positions/{mkt_id}/leverage

Authorization

ApiKeyAuth ApiSignatureAuth ApiTimestampAuth
x-api-key<token>

API key for authentication

In: header

x-api-signature<token>

HMAC-SHA256 signature: base64(HMAC(timestamp + method + path + body, secret))

In: header

x-api-timestamp<token>

Unix timestamp in seconds

In: header

Path Parameters

mkt_id*string

Market ID (e.g., "BTC-PERP", "ETH-PERP").

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json