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
  • Trading account linear, inverse.
  • Normal account: linear, inverse. Please note that category is not involved with business logic
symboltruestringSymbol name
buyLeveragetruestring[1, max leverage of corresponding risk limit].
  • One-way mode: buyLeverage must equal sellLeverage for both Classic and Unified accounts
  • Hedge mode:
    • Classic and Unified (isolated): buyLeverage can be different from sellLeverage
    • Unified (cross): buyLeverage must equal 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
}