avantis

# Avantis Leverage Trading

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

## Quick Start

### Check Positions
```bash
avantis_venv/bin/python skills/avantis/scripts/positions.py
```

### Open Trade
```bash
# 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
```bash
# Close specific position
avantis_venv/bin/python skills/avantis/scripts/close.py <pair_index> <trade_index>

# 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
```python...

# Avantis Leverage Trading Skill

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

## Features

- **Direct wallet integration** - No API key needed
- **Multiple markets** - Crypto (50x), forex/commodities (100x), indices (50x)
- **Long and short** - Profit from price movements in either direction
- **Risk management** - Take profit, stop loss, margin updates
- **Python SDK** - Reliable, well-documented integration

## Quick Start

### Check Positions
```bash
avantis_venv/bin/python skills/avantis/scripts/positions.py
```

### Open Trade
```bash
# 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, TP/SL
avantis_venv/bin/python skills/avantis/scripts/trade.py short BTC 20 10 --tp 95000 --sl 102000
```

### Close Position
```bash
# Full close
avantis_venv/bin/python skills/avantis/scripts/close.py 0 0

# Partial close
avantis_venv/bin/python skills/avantis/scripts/close.py 0 0 --amount 5
```

## Requirements

- Python 3.12+
- `avantis-trader-sdk` (installed in virtual env)
- Wallet with USDC on Base
- Gas ETH on Base

## Installation

```bash
# Create virtual environment
python3 -m venv avantis_venv

# Install SDK
avantis_venv/bin/pip install avantis-trader-sdk

# Set up wallet
echo "Private Key: 0xYOUR_KEY_HERE" > MAIN_WALLET.txt
```

## Supported Markets

### Crypto (up to 50x)
ETH, BTC, SOL, LINK, ARB, OP, AVAX, and more

### 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

## Position Sizing

**Minimum position size**: ~$100
- $4 collateral × 25x leverage = $100 ✅
- $5 collateral × 20x leverage = $100 ✅
- $10 collateral × 10x leverage = $100 ✅

## Fee Structure

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