Skip to main content

Set Leverage

Set the leverage

Normal account covers: USDT perpetual / Inverse contract

HTTP Request

POST /cloud/trade/v3/position/set-leverage

Request Parameters

ParameterRequiredTypeComments
categorytruestringProduct type
  • Normal account: linear, inverse. Please note that category is not involved with business logic
symboltruestringSymbol name
buyLeveragetruestring[1, max leverage of corresponding risk limit]. Note: Under one-way mode, buyLeverage must be the same as sellLeverage
sellLeveragetruestring[1, max leverage of corresponding risk limit]. Note: Under one-way mode, buyLeverage must be the same as sellLeverage

Response Parameters

None

Request Example

POST /cloud/trade/v3/position/set-leverage HTTP/1.1
Host: openapi-testnet.zoomex.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672281605082
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
"category": "linear",
"symbol": "BTCUSDT",
"buyLeverage": "6",
"sellLeverage": "6"

}

Response Example

{
"retCode": 0,
"retMsg": "OK",
"result": {},
"retExtInfo": {},
"time": 1672281607343
}