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",
  "dexReceivedTimestamp": 1710010900000,
  "hyperethTimestamp": 1710011000000
}

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)

​
dexReceivedTimestamp
integer<int64>

Timestamp when HyperETH API server received this message from the venue (in milliseconds)

​
hyperethTimestamp
integer<int64>

Timestamp when HyperETH API server completed all processing before returning to client (in milliseconds)