Set Leverage (Aster)

Configure leverage for trading on Aster exchange. Leverage allows you to control larger positions with less capital.

Features

Flexible leverage: Set leverage from 1x to 125x
Symbol-specific: Configure different leverage for each trading pair
Risk management: Higher leverage increases both potential profits and losses

Aster - Set Leverage

Configure leverage for a specific trading pair on Aster exchange.

Endpoint

POST /api/aster/perp/:walletId/leverage

Path Parameters

Parameter	Type	Required	Description
`walletId`	string	Yes	Wallet ID (UUID)

Request Body

{
  "symbol": "PERPUSDT",
  "leverage": 25
}

Request Parameters

Field	Type	Required	Description
`symbol`	string	Yes	Trading pair (e.g., “BTCUSDT”, “PERPUSDT”)
`leverage`	number	Yes	Leverage multiplier (1-125)

Example Request

curl -X POST https://api.tide.ag/api/aster/perp/ee337309-3e77-4278-b21a-4681468168ba/leverage \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "PERPUSDT",
    "leverage": 25
  }'

Success Response

{
  "success": true,
  "data": {
    "symbol": "PERPUSDT",
    "leverage": 25,
    "maxNotionalValue": "25000"
  }
}

Response Fields

Field	Type	Description
`symbol`	string	Trading pair
`leverage`	number	Configured leverage multiplier
`maxNotionalValue`	string	Maximum notional value for positions with this leverage

Use Cases

Set leverage before opening a position
Adjust risk exposure for different trading strategies
Configure different leverage levels for various trading pairs
Implement dynamic leverage based on market conditions

Important Notes

High Leverage Risk: Higher leverage amplifies both gains and losses. A 125x leverage position can be liquidated with less than 1% adverse price movement.

Leverage must be set before placing orders. The leverage setting applies to all future orders for the specified symbol until changed.

Start with lower leverage (5-10x) when learning to trade perpetual futures. Increase leverage gradually as you gain experience.

Avantis Leverage

Avantis leverage is configured per-trade at execution time (not via a separate API call). Leverage is passed directly in the openPosition request. Limits vary by order type and pair:

Order Type	Pairs	Min	Max
MARKET / LIMIT / STOP_LIMIT	All pairs	1x	50x (ETH/BTC: 75x)
MARKET_ZERO_FEE	ETH, BTC, SOL only	75x	250x

Avantis does not have a separate set-leverage endpoint. Leverage is specified in each trade request and applies to that individual position.

Leverage Guidelines

Leverage	Risk Level	Use Case
1-5x	Low	Conservative trading, learning
5-20x	Medium	Standard trading strategies
20-50x	High	Experienced traders, short-term trades
50-125x	Very High	Expert traders only, scalping
75-250x	Extreme	Avantis zero-fee positions (ETH/BTC/SOL only)

Error Responses

400 Bad Request - Invalid Leverage

{
  "success": false,
  "error": "Leverage must be between 1 and 125",
  "timestamp": 1698840000000
}

400 Bad Request - Invalid Symbol

{
  "success": false,
  "error": "Invalid trading symbol",
  "timestamp": 1698840000000
}

401 Unauthorized - Missing Wallet ID

{
  "success": false,
  "error": "Invalid wallet ID",
  "timestamp": 1698840000000
}

Getting Started

Market Data

Trading

Positions

Account

System

Guides

Features

Aster - Set Leverage

Endpoint

Path Parameters

Request Body

Request Parameters

Example Request

Success Response

Response Fields

Use Cases

Important Notes

Avantis Leverage

Leverage Guidelines

Error Responses

400 Bad Request - Invalid Leverage

400 Bad Request - Invalid Symbol

401 Unauthorized - Missing Wallet ID

​Features

​Aster - Set Leverage

​Endpoint

​Path Parameters

​Request Body

​Request Parameters

​Example Request

​Success Response

​Response Fields

​Use Cases

​Important Notes

​Avantis Leverage

​Leverage Guidelines

​Error Responses

​400 Bad Request - Invalid Leverage

​400 Bad Request - Invalid Symbol

​401 Unauthorized - Missing Wallet ID

Features

Aster - Set Leverage

Endpoint

Path Parameters

Request Body

Request Parameters

Example Request

Success Response

Response Fields

Use Cases

Important Notes

Avantis Leverage

Leverage Guidelines

Error Responses

400 Bad Request - Invalid Leverage

400 Bad Request - Invalid Symbol

401 Unauthorized - Missing Wallet ID