GET

/api/v1/exchanges/:id/leverage_data

Permission: EXCHANGES_READSecurity: SIGNED

Returns a list of leverage configurations and margin modes (cross, isolated, none) supported by the exchange market for an account and trading pair.

Path Parameters

idUUID string required

Unique Quentrade UUID of this exchange account entity.

Query Parameters

pairstring optional

The trading pair to query leverage limits for (e.g. USDT_BTC or USDC_DOGE).

Example Request

GETGET /api/v1/exchanges/7fa84b80-77a8-4e89-a292-123456789abc/leverage_data?pair=USDT_BTC

Response Parameters

codestring

Unique code identifying the leverage mode (none, cross, isolated).

namestring

Display name for the leverage mode.

can_set_leverage_valueboolean

Indicates whether the leverage value can be configured by the user (true) or is fixed (false).

max_leveragestring or null

Maximum allowable leverage multiplier for this type, or null if default/unlimited.

available_leverage_valuesarray[number]

List of specific discrete leverage values supported by the exchange, if applicable.

validobject

Object specifying minimum and maximum allowable leverage limits.

minstring or null

Minimum allowable leverage value (e.g. "1.0").

maxstring or null

Maximum allowable leverage value, or null if unbounded.

Example Responses

account_leverage_200.json
200 OK
[
  {
    "code": "none",
    "name": "Not specified",
    "can_set_leverage_value": false,
    "max_leverage": null,
    "available_leverage_values": [],
    "valid": {}
  },
  {
    "code": "cross",
    "name": "Cross",
    "can_set_leverage_value": true,
    "max_leverage": null,
    "available_leverage_values": [],
    "valid": {
      "min": "1.0",
      "max": null
    }
  },
  {
    "code": "isolated",
    "name": "Isolated",
    "can_set_leverage_value": true,
    "max_leverage": null,
    "available_leverage_values": [],
    "valid": {
      "min": "1.0",
      "max": null
    }
  }
]