Set the leverage setting for a market
PUT/v3/leveragepreferences
Sets a contract's margin mode, either "isolated" or "cross" margin.
When specifying a max leverage, the contract's margin mode will be isolated.
Calling this endpoint can result in the following error codes:
- 87: Contract does not exist
- 88: Contract not a multi-collateral futures contract
- 41: Would cause liquidation
Request
Query Parameters
Symbol for the leverage preference.
Max leverage to set.
When present, the symbol's margin mode will be set to "isolated".
Responses
- 200
OK
- application/x-www-form-urlencoded
- Schema
- success
Schema
- SuccessResponse
- ErrorResponse
accountInactive: The Futures account the request refers to is inactiveapiLimitExceeded: The API limit for the calling IP address has been exceededauthenticationError: The request could not be authenticatedinsufficientFunds: The amount requested for transfer is below the amount of funds availableinvalidAccount: The Futures account the transfer request refers to is invalidinvalidAmount: The amount the transfer request refers to is invalidinvalidArgument: One or more arguments provided are invalidinvalidUnit: The unit the transfer request refers to is invalidJson Parse Error: The request failed to pass valid JSON as an argumentmarketUnavailable: The market is currently unavailablenonceBelowThreshold: The provided nonce is below the thresholdnonceDuplicate: The provided nonce is a duplicate as it has been used in a previous requestnotFound: The requested information could not be foundrequiredArgumentMissing: One or more required arguments are missingServer Error: There was an error processing the requestUnavailable: The endpoint being called is unavailableunknownError: An unknown error has occurred
Server time in Coordinated Universal Time (UTC)
Possible values: [success]
Server time in Coordinated Universal Time (UTC)
Possible values: [error]
Possible values: [accountInactive, apiLimitExceeded, authenticationError, insufficientFunds, invalidAccount, invalidAmount, invalidArgument, invalidUnit, Json Parse Error, marketUnavailable, nonceBelowThreshold, nonceDuplicate, notFound, requiredArgumentMissing, Server Error, Unavailable, unknownError]
Possible values: [accountInactive, apiLimitExceeded, authenticationError, insufficientFunds, invalidAccount, invalidAmount, invalidArgument, invalidUnit, Json Parse Error, marketUnavailable, nonceBelowThreshold, nonceDuplicate, notFound, requiredArgumentMissing, Server Error, Unavailable, unknownError]
Error description.
{
"result": "success",
"serverTime": "2022-06-28T14:48:58.711Z"
}