Avantis Skill

---

name: avantis description: Execute leverage trading on Avantis (Base). Long/short crypto, forex, commodities with up to 100x leverage. Uses Python SDK with direct wallet integration. metadata: author: beanbot version: "1.0.0" requires: - Python 3.12+ - avantis-trader-sdk - Wallet: 0x79622Ea91BBbDF860e9b0497E4C297fC52c8CE64

---

Avantis Leverage Trading

Execute leverage trades on Avantis - Base's largest derivatives exchange for crypto, forex, commodities, and indices.

Quick Start

Check Positions

avantis_venv/bin/python skills/avantis/scripts/positions.py

Open Trade

# 5x long ETH with $10 collateral
avantis_venv/bin/python skills/avantis/scripts/trade.py long ETH 10 5
10x short BTC with $20 collateral
avantis_venv/bin/python skills/avantis/scripts/trade.py short BTC 20 10

Close Position

# Close specific position
avantis_venv/bin/python skills/avantis/scripts/close.py  
Or close all positions for a pair
avantis_venv/bin/python skills/avantis/scripts/close.py ETH

Wallet Configuration

Main Wallet: 0x79622Ea91BBbDF860e9b0497E4C297fC52c8CE64

Private key: /home/ubuntu/clawd/MAIN_WALLET.txt

USDC approved: 100 USDC

Gas balance: 0.004500 ETH (~89 trades)

Supported Markets

Crypto (up to 50x)

ETH/USD, BTC/USD, SOL/USD, LINK/USD

ARB/USD, OP/USD, AVAX/USD, etc.

Forex (up to 100x)

EUR/USD, GBP/USD, USD/JPY, AUD/USD

USD/CAD, USD/CHF, NZD/USD

Commodities (up to 100x)

Gold (XAU/USD), Silver (XAG/USD)

Oil (WTI, Brent)

Indices (up to 50x)

SPX, NDX, DJI

Features

Leverage Trading

Long: Profit when price goes up

Short: Profit when price goes down

Min leverage: 2x

Max leverage: 50x crypto, 100x forex/commodities

Risk Management

Take Profit: Auto-close at target price (max 500% of entry)

Stop Loss: Auto-close to limit losses

Margin Updates: Add/remove collateral to adjust leverage

Partial Close: Close portion of position

Fee Features

Loss Protection: Up to 20% rebate on losses when trading against popular sentiment

Positive Slippage: Better execution when helping balance open interest

Dynamic Fees: 0.04-0.1% based on market conditions

Common Operations

Open a Position

# Long ETH: 5x leverage, $10 collateral
Position size: $50 (10 × 5)
python scripts/trade.py long ETH 10 5
With take profit and stop loss
python scripts/trade.py long ETH 10 5 --tp 3500 --sl 3000

Check Positions

python scripts/positions.py
Output:
📊 Open positions: 1
  • LONG 5x | $10 collateral | ETH/USD
  • Entry: $3200 | Current: $3250
  • PnL: +$7.81 (+7.81%)

Close Position

# Full close
python scripts/close.py 0 0  # pair_index=0 (ETH), trade_index=0
Partial close (50%)
python scripts/close.py 0 0 --amount 5

Update Stop Loss / Take Profit

python scripts/update-tpsl.py 0 0 --tp 3800 --sl 3100

Position Sizing Guide

Minimum Position Size

ETH/USD: ~$30 minimum position

BTC/USD: ~$50 minimum position

Formula: collateral × leverage ≥ minimum

Examples

❌ $5 × 5x = $25 position (too small for ETH)

✅ $10 × 5x = $50 position (works for ETH)

✅ $20 × 2.5x = $50 position (works for ETH)

Recommended Sizing

Start small: $10-20 collateral for testing

Scale up: After confirming strategy works

Max risk: Don't exceed 5-10% of account per trade

Leverage Guidelines

Conservative (2-5x)

Lower liquidation risk

Smaller gains/losses

Good for: Learning, uncertain markets

Moderate (5-10x)

Balanced risk/reward

Common for crypto trading

Good for: Directional plays

Aggressive (10-50x)

High liquidation risk

Large potential gains/losses

Good for: Short-term scalping, tight stops

Extreme (50-100x)

Very high liquidation risk

Only for forex/commodities

Good for: Expert traders only

Fees & Costs

Trading Fees

Opening: 0.04-0.1% of position size (dynamic)

Closing: 0.04-0.1% of position size

Example: $50 position × 0.08% = $0.04 fee

Execution Fee

Cost: ~$0.10-0.30 in ETH per transaction

Covers: Base network gas fees

Auto-calculated: SDK handles this

Margin Fee

Accrual: 0.02-0.05% daily on position size

Example: $50 position × 0.03% = $0.015/day

Deducted: When closing or updating margin

Risk Warnings

⚠️ Liquidation Risk

Position liquidates if losses exceed collateral

Higher leverage = faster liquidation

Monitor positions regularly

⚠️ Market Risk

Crypto/forex markets are volatile

Prices can move against you quickly

Use stop losses

⚠️ Fee Impact

Small positions pay proportionally more fees

Margin fees accrue daily

Factor fees into profit calculations

Best Practices

Before Trading

1. Check balance: Ensure sufficient USDC + gas 2. Check market: Look at current price/volatility 3. Calculate risk: Know your max loss 4. Set stops: Always use stop loss for leverage

During Trade

1. Monitor positions: Check regularly (especially high leverage) 2. Adjust if needed: Update TP/SL based on market 3. Scale out: Consider partial closes to lock profit 4. Watch fees: Margin fees accrue daily

After Trade

1. Review performance: What worked, what didn't 2. Update strategy: Adjust sizing/leverage based on results 3. Document lessons: Add to continuous-learning instincts

Common Issues

"BELOW_MIN_POS" Error

Position size too small

Solution: Increase collateral or leverage

"Price Feed Down" (503 Error)

Avantis infrastructure issue

Solution: Wait 5-10 minutes and retry

"Insufficient Balance"

Not enough USDC or gas

Solution: Add funds to wallet

Transaction Reverts

Usually approval or balance issue

Solution: Check allowance, re-approve if needed

Advanced Features

Limit Orders

# Open long at specific price
python scripts/trade.py long ETH 10 5 --limit 3000

Margin Updates

# Add $5 collateral (reduces leverage)
python scripts/update-margin.py 0 0 --deposit 5
Remove $3 collateral (increases leverage)
python scripts/update-margin.py 0 0 --withdraw 3

Market Research

# Get current price + analysis
python scripts/market-info.py ETH
Compare multiple assets
python scripts/market-info.py ETH BTC SOL

Integration with Other Skills

Bankr (Optional)

Can use Bankr for market research

Avantis for actual trade execution

Keep separate for now (different wallets)

Continuous Learning

Track successful strategies in instincts/crypto/

Note leverage levels that work

Document entry/exit patterns

Strategic Compact

Checkpoint after closing positions

Review performance during checkpoints

Adjust strategy based on results

Resources

Platform: https://avantisfi.com

SDK Docs: https://sdk.avantisfi.com

Trading Guide: https://docs.avantisfi.com

Discord: https://discord.gg/avantis

Scripts Reference

All scripts in skills/avantis/scripts/:

positions.py - View open positions

trade.py - Open new position

close.py - Close position (full or partial)

update-tpsl.py - Update take profit / stop loss

update-margin.py - Add/remove collateral

market-info.py - Get market data

balance.py - Check wallet balances

Installation

The SDK is already installed in /home/ubuntu/clawd/avantis_venv/:

# Activate venv (if needed for manual testing)
source /home/ubuntu/clawd/avantis_venv/bin/activate
Check installation
python -c "from avantis_trader_sdk import TraderClient; print('✓ SDK ready')"

Safety Checklist

Before every trade:

[ ] Check wallet balance (USDC + gas)

[ ] Verify leverage is appropriate

[ ] Set stop loss

[ ] Confirm position size meets minimum

[ ] Understand max loss scenario

[ ] Have exit plan ready

---

⚠️ Important: Leverage trading is high risk. Start small, use stop losses, never risk more than you can afford to lose.

❌ $5 × 5x = $25 position (too small for ETH)

✅ $10 × 5x = $50 position (works for ETH)

✅ $20 × 2.5x = $50 position (works for ETH)

Recommended Sizing

Start small: $10-20 collateral for testing

Scale up: After confirming strategy works

Max risk: Don't exceed 5-10% of account per trade

Before Trading

1. Check balance: Ensure sufficient USDC + gas 2. Check market: Look at current price/volatility 3. Calculate risk: Know your max loss 4. Set stops: Always use stop loss for leverage

During Trade

1. Monitor positions: Check regularly (especially high leverage) 2. Adjust if needed: Update TP/SL based on market 3. Scale out: Consider partial closes to lock profit 4. Watch fees: Margin fees accrue daily

After Trade

1. Review performance: What worked, what didn't 2. Update strategy: Adjust sizing/leverage based on results 3. Document lessons: Add to continuous-learning instincts