aster-trading

name	aster-trading
description	Aster DEX trading skill for futures, spot, and market data via MCP tools
keywords	trading, crypto, DeFi, perpetuals, futures, spot, Aster DEX, market data, orders, positions, leverage

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)

Tool	Description
ping	Test Aster API connectivity
get_ticker	24h ticker / latest price for a futures symbol
get_order_book	Order book depth (bids/asks)
get_klines	Candlestick/K-line data (1m, 5m, 1h, 4h, 1d)
get_funding_rate	Current funding rate and mark price
get_funding_info	Funding rate configuration
get_exchange_info	Exchange rules and contract specifications
get_spot_ticker	24h spot ticker
get_spot_price	Latest spot price
get_spot_order_book	Spot order book depth
get_spot_klines	Spot candlestick data
get_spot_exchange_info	Spot trading rules

Account (requires configured account)

Tool	Description
get_balance	Futures account balance
get_positions	Open positions (optionally filtered by symbol)
get_account_info	Account info with position summary
get_account_v4	Full account info (assets + positions)
get_income	PnL and fee flow (TRANSFER, REALIZED_PNL, FUNDING_FEE, COMMISSION)
get_commission_rate	Trading fee rate for a symbol
get_leverage_bracket	Leverage tier brackets
get_spot_account	Spot account balances (free/locked)

Futures Orders

Tool	Description
create_order	Place order (LIMIT, MARKET, STOP, STOP_MARKET)
cancel_order	Cancel by order_id or client_order_id
cancel_all_orders	Cancel all open orders for a symbol
get_order	Query single order
get_open_orders	List current open orders
get_all_orders	Order history
get_my_trades	Trade/fill history

Spot Orders

Tool	Description
create_spot_order	Place spot order
cancel_spot_order	Cancel spot order
cancel_spot_all_orders	Cancel all spot orders for a symbol
get_spot_order	Query spot order
get_spot_open_orders	List open spot orders
get_spot_all_orders	Spot order history
get_spot_my_trades	Spot trade history
get_spot_transaction_history	Spot transaction flow
get_spot_commission_rate	Spot fee rate

Position & Risk Management

Tool	Description
set_leverage	Set leverage multiplier for a symbol
set_margin_mode	Set ISOLATED or CROSSED margin
transfer_funds	Transfer between spot and futures (type 1=spot->futures, 2=futures->spot)
transfer_spot_futures	Spot-futures transfer (SPOT_FUTURE or FUTURE_SPOT)

System

Tool	Description
get_server_info	MCP server info, configured accounts, tool count

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.

2. 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

3. 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

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

5. 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

Type	URL
Futures REST	https://fapi.asterdex.com
Spot REST	https://sapi.asterdex.com
WebSocket	wss://fstream.asterdex.com

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

Indicator	Bullish Signal	Bearish Signal
RSI(14)	Below 30 (oversold)	Above 70 (overbought)
MACD	Signal line crossover up	Signal line crossover down
Bollinger Bands	Price touches lower band	Price touches upper band
Funding Rate	Negative (shorts paying)	Very positive (longs paying)
Volume	Increasing on uptrend	Increasing on downtrend

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