Skip to main content
POST
/
updateLeverage
curl --request POST \
  --url https://api.hypereth.io/v2/hyperliquid/updateLeverage \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "symbol": "BTC",
  "leverage": 10,
  "marginType": "cross"
}'
{
  "symbol": "BTC",
  "leverage": "10",
  "marginType": "cross",
  "maxNotional": "1000000"
}

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
symbol
string
required

Unified market symbol

Example:

"BTC"

​
leverage
number
required

Target leverage value. Valid range depends on platform and position size (typically 1-125).

Example:

10

​
marginType
enum<string>
required

Margin type (cross or isolated)

Available options:
cross,
isolated

Response

200 - application/json

Leverage updated successfully

​
symbol
string

Trading symbol

​
leverage
string

Updated leverage value

​
marginType
string

Margin type (cross or isolated)

​
maxNotional
string | null

Maximum notional value allowed at this leverage (if available)