Portfolios

Set leverage

Update the leverage for a specific market position. The new leverage must be between 1 and the market's maximum leverage (the max_lev field from GET /markets). Different markets have different maximum leverage values (e.g., 20 for crypto, 10 for equities, 5 for prediction markets).

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