Leverage & Margin
Configure leverage and margin type for trading pairs
Set Leverage
Change the leverage for a trading pair. The new leverage is saved to your account and persists across sessions and devices.
POST /v1/futures/leverage
Authorization: Bearer <token>
Content-Type: application/json
{
"symbol": "BTCUSDT",
"leverage": 20
}| Field | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Trading pair |
leverage | number | Yes | Leverage multiplier (1-125) |
Response:
{
"ok": true,
"data": {
"leverage": 20,
"symbol": "BTCUSDT"
}
}Your default leverage is returned in the authentication response (defaultLeverage) so the UI can display the correct value immediately on page load.
Set Margin Type
Switch between Cross and Isolated margin modes. The selected margin type is saved to your account.
POST /v1/futures/margin-type
Authorization: Bearer <token>
Content-Type: application/json
{
"symbol": "BTCUSDT",
"marginType": "ISOLATED"
}| Field | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Trading pair |
marginType | string | Yes | CROSSED or ISOLATED |
Margin Types:
| Type | Description |
|---|---|
CROSSED | All positions share the same margin pool. Lower liquidation risk but entire balance is at risk |
ISOLATED | Each position has its own margin. Limits loss to the position's margin only |
Changing margin type saves your preference — it is applied automatically when you place your next order via the marginType parameter. This means the change is instant and never fails.
Default Settings
When you first create an account, the default settings are:
| Setting | Default |
|---|---|
| Leverage | 10x |
| Margin Type | Cross |
These defaults are returned in the authentication response:
{
"ok": true,
"user": {
"id": "clx...",
"walletAddress": "0x...",
"accountId": "clx...",
"subAccountId": "34696153",
"defaultLeverage": 10,
"defaultMarginType": "CROSSED"
}
}When you change leverage or margin type, the new values are saved and will be returned on your next login — even from a different device.