kmshihab7878/claude-code-setup/aster-trading

Aster DEX Trading Skill

Aster DEX is a next-generation perpetual futures and spot exchange backed by YZi Labs. This skill provides trading capabilities through the aster MCP server.

Available MCP Tools

Market Data (no auth required)

Account (requires configured account)

Futures Orders

Spot Orders

Position & Risk Management

System

Setup

API keys are managed exclusively through the encrypted config:

# Configure HMAC account
aster-mcp config
 
# Configure EIP-712 (V3) account
aster-mcp config --account-id main --auth-type v3
 
# List configured accounts
aster-mcp list
 
# Test connectivity
aster-mcp test main

Keys are stored with Fernet encryption in ~/.config/aster-mcp/.

Risk & Safety Rules

CRITICAL: These rules are mandatory for all trading operations.

1. User confirmation required: ALWAYS confirm with the user before placing ANY order. Display the full order details (symbol, side, type, quantity, price, leverage) and ask for explicit approval.

1. Position size disclosure: Before executing, show:

• Position size in USD equivalent
• Current leverage setting
• Estimated liquidation price (if available)
• Current account balance and margin usage

1. Leverage warnings:

• Aster supports up to 1,001x leverage
• For leverage > 10x: note elevated risk
• For leverage > 20x: display explicit warning about liquidation risk
• For leverage > 50x: strongly advise against unless user is experienced
• For leverage > 100x: refuse unless user explicitly confirms understanding of extreme risk

1. Never auto-execute: No order placement without user seeing a preview and confirming.

1. Rate limits: Respect Aster API rate limits. If receiving 429 responses, back off and inform the user.

Security Constraints

• API keys are managed ONLY through aster-mcp config (Fernet encrypted)
• NEVER log, display, or output full API keys or secrets
• NEVER commit credentials to git
• NEVER store API keys in plain text files
• Config directory: ~/.config/aster-mcp/ (encrypted)

Common Workflows

Check a price

1. Call get_ticker with symbol="BTCUSDT"
2. Display: last price, 24h change %, 24h volume

Place a limit buy order

1. Call get_ticker to show current price
2. Call get_balance to show available margin
3. Present order preview: symbol, side=BUY, type=LIMIT, quantity, price
4. Wait for user confirmation
5. Call create_order with confirmed parameters
6. Display order result (orderId, status, filled quantity)

Close a position

1. Call get_positions to show open positions
2. Identify the position to close
3. Create a closing order (opposite side, reduce_only=true)
4. Wait for user confirmation
5. Execute and display result

Check portfolio

1. Call get_balance for margin/PnL overview
2. Call get_positions for open positions
3. Call get_open_orders for pending orders
4. Present consolidated portfolio view

Symbol Format

Symbols accept both formats and are normalized internally:

• BTCUSDT or BTC/USDT -> BTCUSDT
• ETHUSDT or ETH/USDT -> ETHUSDT

API Base URLs

ML-Informed Trading Patterns

Signal Generation Workflow

1. Fetch candles: get_klines(symbol, interval="1h", limit=500)
2. Calculate indicators: RSI, MACD, Bollinger Bands, ATR
3. Run ML model: feature engineering → prediction → confidence score
4. Generate signal: BUY/SELL/HOLD with confidence (0.0-1.0)
5. Position sizing: Kelly criterion or fixed fractional (see finance-ml skill)
6. Risk check: get_balance() + get_positions() → verify margin availability
7. Present to user with full details (MANDATORY confirmation)
8. Execute if confirmed: create_order(...)

Key Technical Indicators for Crypto

Risk Management Integration

• Always check funding rate before entering perpetual positions
• Use ATR-based stop losses: stop = entry ± (ATR × multiplier)
• Maximum position size: never risk more than 2% of account per trade
• Correlation check: don't hold multiple highly correlated positions

Cross-References

• finance-ml skill: ML models, feature engineering, risk metrics, backtesting
• FINANCE_ML_STACK.md: Comprehensive financial ML reference