# Send Avantis Skill to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "avantis-skill",
    "name": "Avantis Skill",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/droppingbeans/avantis-skill",
    "canonicalUrl": "https://clawhub.ai/droppingbeans/avantis-skill",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/avantis-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=avantis-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/quick-start.md",
      "scripts/check-positions.py",
      "scripts/close.py",
      "scripts/positions.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "avantis-skill",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T00:42:31.415Z",
      "expiresAt": "2026-05-07T00:42:31.415Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=avantis-skill",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=avantis-skill",
        "contentDisposition": "attachment; filename=\"avantis-skill-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "avantis-skill"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/avantis-skill"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/avantis-skill",
    "downloadUrl": "https://openagent3.xyz/downloads/avantis-skill",
    "agentUrl": "https://openagent3.xyz/skills/avantis-skill/agent",
    "manifestUrl": "https://openagent3.xyz/skills/avantis-skill/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/avantis-skill/agent.md"
  }
}
```
## Documentation

### Avantis Leverage Trading

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

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

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

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

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

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

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

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

### Before Trading

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

### During Trade

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

### After Trade

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

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

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

### 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.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: droppingbeans
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T00:42:31.415Z
- Expires at: 2026-05-07T00:42:31.415Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/avantis-skill)
- [Send to Agent page](https://openagent3.xyz/skills/avantis-skill/agent)
- [JSON manifest](https://openagent3.xyz/skills/avantis-skill/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/avantis-skill/agent.md)
- [Download page](https://openagent3.xyz/downloads/avantis-skill)