Skip to main content

Get Sub-Account Position Leverage Multipliers

The master account uses this endpoint to query the position leverage of a specified sub-account on a given contract.

HTTP Request

  • GET /api/v1/private/position/leverage/subaccount

Required Permission: View Order Details (master-account API Key only)

Request Parameters

ParameterTypeRequiredDescription
subAccountstringtrueSub-account name; can be obtained from the Query Sub-Account List endpoint
symbolstringtrueContract name

Response Parameters

ParameterTypeDescription
subAccountstringSub-account name
symbolstringContract name
positionTypeintPosition type, 1 long 2 short
openTypeintOpen type, 1: isolated, 2: cross
leverageintLeverage
maxLeverageViewintMaximum leverage
currentMmrdecimalMaintenance margin rate

Notes

  • The response structure is consistent with Get Position Leverage Multipliers, with additional subAccount and subUid fields to identify the sub-account.
  • Calling this endpoint with a sub-account API Key returns a permission error; the same applies when subAccount does not belong to the current master account.
  • Returned items are grouped by positionType (long/short). If the corresponding position is not open, the default leverage configuration for that contract is still returned.

Response

{
"success": true,
"code": 0,
"data": [
{
"subAccount": "mexc_sub_01",
"subUid": "49910511",
"symbol": "BTC_USDT",
"level": 6,
"maxVol": 4500000,
"mmr": 0.05,
"imr": 0.1,
"positionType": 1,
"openType": 1,
"leverage": 2,
"limitBySys": false,
"currentMmr": 0.001,
"maxLeverageView": 500
},
{
"subAccount": "mexc_sub_01",
"subUid": "49910511",
"symbol": "BTC_USDT",
"level": 6,
"maxVol": 4500000,
"mmr": 0.05,
"imr": 0.1,
"positionType": 2,
"openType": 1,
"leverage": 2,
"limitBySys": false,
"currentMmr": 0.001,
"maxLeverageView": 500
}
]
}