Adjust Leverage

Adjust user's leverage and margin type for a specified trading pair.

HTTP Request

POST

/api/perp-trade-api/user-config/adjust-leverage

Request Frequency Restriction:

Recommended: no more than 10 times per second

Authentication Required:

JWT Token required
X-Wallet-Address header required

Request Headers

Name	Type	Required	Description
Authorization	string	Yes	JWT Token, format: `Bearer {token}`
X-Wallet-Address	string	Yes	Wallet address

Request Parameters

Name	Type	Required	Description
symbol	string	Yes	Trading pair, e.g., ETH-PERP
leverage	string	Yes	Leverage (BigInteger string), e.g., "11000000000000000000" means 11x
marginType	string	Yes	Margin type: ISOLATED (isolated) or CROSSED (cross)

Note

Leverage cannot exceed the maximum leverage limit of the trading pair
Adjusting leverage may affect the liquidation price of positions

Request Example

{
  "symbol": "ETH-PERP",
  "leverage": "11000000000000000000",
  "marginType": "ISOLATED"
}

Response Fields Description

Name	Type	Description
address	string	User address
symbol	string	Trading pair
leverage	decimal	Leverage
marginType	string	Margin type
createTime	long	Creation time (milliseconds)

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "address": "0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78",
    "symbol": "ETH-PERP",
    "leverage": 11,
    "marginType": "ISOLATED",
    "createTime": 1700000000000
  }
}