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.dexaggregatorbeta.xyz/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.
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 |
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
}
