{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/avantis-skill",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=avantis-skill",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/quick-start.md",
      "scripts/check-positions.py",
      "scripts/close.py",
      "scripts/positions.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/avantis-skill",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Avantis Leverage Trading",
        "body": "Execute leverage trades on Avantis - Base's largest derivatives exchange for crypto, forex, commodities, and indices."
      },
      {
        "title": "Check Positions",
        "body": "avantis_venv/bin/python skills/avantis/scripts/positions.py"
      },
      {
        "title": "Open Trade",
        "body": "# 5x long ETH with $10 collateral\navantis_venv/bin/python skills/avantis/scripts/trade.py long ETH 10 5\n\n# 10x short BTC with $20 collateral\navantis_venv/bin/python skills/avantis/scripts/trade.py short BTC 20 10"
      },
      {
        "title": "Close Position",
        "body": "# Close specific position\navantis_venv/bin/python skills/avantis/scripts/close.py <pair_index> <trade_index>\n\n# Or close all positions for a pair\navantis_venv/bin/python skills/avantis/scripts/close.py ETH"
      },
      {
        "title": "Wallet Configuration",
        "body": "Main Wallet: 0x79622Ea91BBbDF860e9b0497E4C297fC52c8CE64\n\nPrivate key: /home/ubuntu/clawd/MAIN_WALLET.txt\nUSDC approved: 100 USDC\nGas balance: 0.004500 ETH (~89 trades)"
      },
      {
        "title": "Crypto (up to 50x)",
        "body": "ETH/USD, BTC/USD, SOL/USD, LINK/USD\nARB/USD, OP/USD, AVAX/USD, etc."
      },
      {
        "title": "Forex (up to 100x)",
        "body": "EUR/USD, GBP/USD, USD/JPY, AUD/USD\nUSD/CAD, USD/CHF, NZD/USD"
      },
      {
        "title": "Commodities (up to 100x)",
        "body": "Gold (XAU/USD), Silver (XAG/USD)\nOil (WTI, Brent)"
      },
      {
        "title": "Indices (up to 50x)",
        "body": "SPX, NDX, DJI"
      },
      {
        "title": "Leverage Trading",
        "body": "Long: Profit when price goes up\nShort: Profit when price goes down\nMin leverage: 2x\nMax leverage: 50x crypto, 100x forex/commodities"
      },
      {
        "title": "Risk Management",
        "body": "Take Profit: Auto-close at target price (max 500% of entry)\nStop Loss: Auto-close to limit losses\nMargin Updates: Add/remove collateral to adjust leverage\nPartial Close: Close portion of position"
      },
      {
        "title": "Fee Features",
        "body": "Loss Protection: Up to 20% rebate on losses when trading against popular sentiment\nPositive Slippage: Better execution when helping balance open interest\nDynamic Fees: 0.04-0.1% based on market conditions"
      },
      {
        "title": "Open a Position",
        "body": "# Long ETH: 5x leverage, $10 collateral\n# Position size: $50 (10 × 5)\npython scripts/trade.py long ETH 10 5\n\n# With take profit and stop loss\npython scripts/trade.py long ETH 10 5 --tp 3500 --sl 3000"
      },
      {
        "title": "Check Positions",
        "body": "python scripts/positions.py\n\n# Output:\n# 📊 Open positions: 1\n#   • LONG 5x | $10 collateral | ETH/USD\n#   • Entry: $3200 | Current: $3250\n#   • PnL: +$7.81 (+7.81%)"
      },
      {
        "title": "Close Position",
        "body": "# Full close\npython scripts/close.py 0 0  # pair_index=0 (ETH), trade_index=0\n\n# Partial close (50%)\npython scripts/close.py 0 0 --amount 5"
      },
      {
        "title": "Update Stop Loss / Take Profit",
        "body": "python scripts/update-tpsl.py 0 0 --tp 3800 --sl 3100"
      },
      {
        "title": "Minimum Position Size",
        "body": "ETH/USD: ~$30 minimum position\nBTC/USD: ~$50 minimum position\nFormula: collateral × leverage ≥ minimum"
      },
      {
        "title": "Examples",
        "body": "❌ $5 × 5x = $25 position (too small for ETH)\n✅ $10 × 5x = $50 position (works for ETH)\n✅ $20 × 2.5x = $50 position (works for ETH)"
      },
      {
        "title": "Recommended Sizing",
        "body": "Start small: $10-20 collateral for testing\nScale up: After confirming strategy works\nMax risk: Don't exceed 5-10% of account per trade"
      },
      {
        "title": "Conservative (2-5x)",
        "body": "Lower liquidation risk\nSmaller gains/losses\nGood for: Learning, uncertain markets"
      },
      {
        "title": "Moderate (5-10x)",
        "body": "Balanced risk/reward\nCommon for crypto trading\nGood for: Directional plays"
      },
      {
        "title": "Aggressive (10-50x)",
        "body": "High liquidation risk\nLarge potential gains/losses\nGood for: Short-term scalping, tight stops"
      },
      {
        "title": "Extreme (50-100x)",
        "body": "Very high liquidation risk\nOnly for forex/commodities\nGood for: Expert traders only"
      },
      {
        "title": "Trading Fees",
        "body": "Opening: 0.04-0.1% of position size (dynamic)\nClosing: 0.04-0.1% of position size\nExample: $50 position × 0.08% = $0.04 fee"
      },
      {
        "title": "Execution Fee",
        "body": "Cost: ~$0.10-0.30 in ETH per transaction\nCovers: Base network gas fees\nAuto-calculated: SDK handles this"
      },
      {
        "title": "Margin Fee",
        "body": "Accrual: 0.02-0.05% daily on position size\nExample: $50 position × 0.03% = $0.015/day\nDeducted: When closing or updating margin"
      },
      {
        "title": "Risk Warnings",
        "body": "⚠️ Liquidation Risk\n\nPosition liquidates if losses exceed collateral\nHigher leverage = faster liquidation\nMonitor positions regularly\n\n⚠️ Market Risk\n\nCrypto/forex markets are volatile\nPrices can move against you quickly\nUse stop losses\n\n⚠️ Fee Impact\n\nSmall positions pay proportionally more fees\nMargin fees accrue daily\nFactor fees into profit calculations"
      },
      {
        "title": "Before Trading",
        "body": "Check balance: Ensure sufficient USDC + gas\nCheck market: Look at current price/volatility\nCalculate risk: Know your max loss\nSet stops: Always use stop loss for leverage"
      },
      {
        "title": "During Trade",
        "body": "Monitor positions: Check regularly (especially high leverage)\nAdjust if needed: Update TP/SL based on market\nScale out: Consider partial closes to lock profit\nWatch fees: Margin fees accrue daily"
      },
      {
        "title": "After Trade",
        "body": "Review performance: What worked, what didn't\nUpdate strategy: Adjust sizing/leverage based on results\nDocument lessons: Add to continuous-learning instincts"
      },
      {
        "title": "\"BELOW_MIN_POS\" Error",
        "body": "Position size too small\nSolution: Increase collateral or leverage"
      },
      {
        "title": "\"Price Feed Down\" (503 Error)",
        "body": "Avantis infrastructure issue\nSolution: Wait 5-10 minutes and retry"
      },
      {
        "title": "\"Insufficient Balance\"",
        "body": "Not enough USDC or gas\nSolution: Add funds to wallet"
      },
      {
        "title": "Transaction Reverts",
        "body": "Usually approval or balance issue\nSolution: Check allowance, re-approve if needed"
      },
      {
        "title": "Limit Orders",
        "body": "# Open long at specific price\npython scripts/trade.py long ETH 10 5 --limit 3000"
      },
      {
        "title": "Margin Updates",
        "body": "# Add $5 collateral (reduces leverage)\npython scripts/update-margin.py 0 0 --deposit 5\n\n# Remove $3 collateral (increases leverage)\npython scripts/update-margin.py 0 0 --withdraw 3"
      },
      {
        "title": "Market Research",
        "body": "# Get current price + analysis\npython scripts/market-info.py ETH\n\n# Compare multiple assets\npython scripts/market-info.py ETH BTC SOL"
      },
      {
        "title": "Bankr (Optional)",
        "body": "Can use Bankr for market research\nAvantis for actual trade execution\nKeep separate for now (different wallets)"
      },
      {
        "title": "Continuous Learning",
        "body": "Track successful strategies in instincts/crypto/\nNote leverage levels that work\nDocument entry/exit patterns"
      },
      {
        "title": "Strategic Compact",
        "body": "Checkpoint after closing positions\nReview performance during checkpoints\nAdjust strategy based on results"
      },
      {
        "title": "Resources",
        "body": "Platform: https://avantisfi.com\nSDK Docs: https://sdk.avantisfi.com\nTrading Guide: https://docs.avantisfi.com\nDiscord: https://discord.gg/avantis"
      },
      {
        "title": "Scripts Reference",
        "body": "All scripts in skills/avantis/scripts/:\n\npositions.py - View open positions\ntrade.py - Open new position\nclose.py - Close position (full or partial)\nupdate-tpsl.py - Update take profit / stop loss\nupdate-margin.py - Add/remove collateral\nmarket-info.py - Get market data\nbalance.py - Check wallet balances"
      },
      {
        "title": "Installation",
        "body": "The SDK is already installed in /home/ubuntu/clawd/avantis_venv/:\n\n# Activate venv (if needed for manual testing)\nsource /home/ubuntu/clawd/avantis_venv/bin/activate\n\n# Check installation\npython -c \"from avantis_trader_sdk import TraderClient; print('✓ SDK ready')\""
      },
      {
        "title": "Safety Checklist",
        "body": "Before every trade:\n\nCheck wallet balance (USDC + gas)\n Verify leverage is appropriate\n Set stop loss\n Confirm position size meets minimum\n Understand max loss scenario\n Have exit plan ready\n\n⚠️ Important: Leverage trading is high risk. Start small, use stop losses, never risk more than you can afford to lose."
      }
    ],
    "body": "Avantis Leverage Trading\n\nExecute leverage trades on Avantis - Base's largest derivatives exchange for crypto, forex, commodities, and indices.\n\nQuick Start\nCheck Positions\navantis_venv/bin/python skills/avantis/scripts/positions.py\n\nOpen Trade\n# 5x long ETH with $10 collateral\navantis_venv/bin/python skills/avantis/scripts/trade.py long ETH 10 5\n\n# 10x short BTC with $20 collateral\navantis_venv/bin/python skills/avantis/scripts/trade.py short BTC 20 10\n\nClose Position\n# Close specific position\navantis_venv/bin/python skills/avantis/scripts/close.py <pair_index> <trade_index>\n\n# Or close all positions for a pair\navantis_venv/bin/python skills/avantis/scripts/close.py ETH\n\nWallet Configuration\n\nMain Wallet: 0x79622Ea91BBbDF860e9b0497E4C297fC52c8CE64\n\nPrivate key: /home/ubuntu/clawd/MAIN_WALLET.txt\nUSDC approved: 100 USDC\nGas balance: 0.004500 ETH (~89 trades)\nSupported Markets\nCrypto (up to 50x)\nETH/USD, BTC/USD, SOL/USD, LINK/USD\nARB/USD, OP/USD, AVAX/USD, etc.\nForex (up to 100x)\nEUR/USD, GBP/USD, USD/JPY, AUD/USD\nUSD/CAD, USD/CHF, NZD/USD\nCommodities (up to 100x)\nGold (XAU/USD), Silver (XAG/USD)\nOil (WTI, Brent)\nIndices (up to 50x)\nSPX, NDX, DJI\nFeatures\nLeverage Trading\nLong: Profit when price goes up\nShort: Profit when price goes down\nMin leverage: 2x\nMax leverage: 50x crypto, 100x forex/commodities\nRisk Management\nTake Profit: Auto-close at target price (max 500% of entry)\nStop Loss: Auto-close to limit losses\nMargin Updates: Add/remove collateral to adjust leverage\nPartial Close: Close portion of position\nFee Features\nLoss Protection: Up to 20% rebate on losses when trading against popular sentiment\nPositive Slippage: Better execution when helping balance open interest\nDynamic Fees: 0.04-0.1% based on market conditions\nCommon Operations\nOpen a Position\n# Long ETH: 5x leverage, $10 collateral\n# Position size: $50 (10 × 5)\npython scripts/trade.py long ETH 10 5\n\n# With take profit and stop loss\npython scripts/trade.py long ETH 10 5 --tp 3500 --sl 3000\n\nCheck Positions\npython scripts/positions.py\n\n# Output:\n# 📊 Open positions: 1\n#   • LONG 5x | $10 collateral | ETH/USD\n#   • Entry: $3200 | Current: $3250\n#   • PnL: +$7.81 (+7.81%)\n\nClose Position\n# Full close\npython scripts/close.py 0 0  # pair_index=0 (ETH), trade_index=0\n\n# Partial close (50%)\npython scripts/close.py 0 0 --amount 5\n\nUpdate Stop Loss / Take Profit\npython scripts/update-tpsl.py 0 0 --tp 3800 --sl 3100\n\nPosition Sizing Guide\nMinimum Position Size\nETH/USD: ~$30 minimum position\nBTC/USD: ~$50 minimum position\nFormula: collateral × leverage ≥ minimum\nExamples\n❌ $5 × 5x = $25 position (too small for ETH)\n✅ $10 × 5x = $50 position (works for ETH)\n✅ $20 × 2.5x = $50 position (works for ETH)\nRecommended Sizing\nStart small: $10-20 collateral for testing\nScale up: After confirming strategy works\nMax risk: Don't exceed 5-10% of account per trade\nLeverage Guidelines\nConservative (2-5x)\nLower liquidation risk\nSmaller gains/losses\nGood for: Learning, uncertain markets\nModerate (5-10x)\nBalanced risk/reward\nCommon for crypto trading\nGood for: Directional plays\nAggressive (10-50x)\nHigh liquidation risk\nLarge potential gains/losses\nGood for: Short-term scalping, tight stops\nExtreme (50-100x)\nVery high liquidation risk\nOnly for forex/commodities\nGood for: Expert traders only\nFees & Costs\nTrading Fees\nOpening: 0.04-0.1% of position size (dynamic)\nClosing: 0.04-0.1% of position size\nExample: $50 position × 0.08% = $0.04 fee\nExecution Fee\nCost: ~$0.10-0.30 in ETH per transaction\nCovers: Base network gas fees\nAuto-calculated: SDK handles this\nMargin Fee\nAccrual: 0.02-0.05% daily on position size\nExample: $50 position × 0.03% = $0.015/day\nDeducted: When closing or updating margin\nRisk Warnings\n\n⚠️ Liquidation Risk\n\nPosition liquidates if losses exceed collateral\nHigher leverage = faster liquidation\nMonitor positions regularly\n\n⚠️ Market Risk\n\nCrypto/forex markets are volatile\nPrices can move against you quickly\nUse stop losses\n\n⚠️ Fee Impact\n\nSmall positions pay proportionally more fees\nMargin fees accrue daily\nFactor fees into profit calculations\nBest Practices\nBefore Trading\nCheck balance: Ensure sufficient USDC + gas\nCheck market: Look at current price/volatility\nCalculate risk: Know your max loss\nSet stops: Always use stop loss for leverage\nDuring Trade\nMonitor positions: Check regularly (especially high leverage)\nAdjust if needed: Update TP/SL based on market\nScale out: Consider partial closes to lock profit\nWatch fees: Margin fees accrue daily\nAfter Trade\nReview performance: What worked, what didn't\nUpdate strategy: Adjust sizing/leverage based on results\nDocument lessons: Add to continuous-learning instincts\nCommon Issues\n\"BELOW_MIN_POS\" Error\nPosition size too small\nSolution: Increase collateral or leverage\n\"Price Feed Down\" (503 Error)\nAvantis infrastructure issue\nSolution: Wait 5-10 minutes and retry\n\"Insufficient Balance\"\nNot enough USDC or gas\nSolution: Add funds to wallet\nTransaction Reverts\nUsually approval or balance issue\nSolution: Check allowance, re-approve if needed\nAdvanced Features\nLimit Orders\n# Open long at specific price\npython scripts/trade.py long ETH 10 5 --limit 3000\n\nMargin Updates\n# Add $5 collateral (reduces leverage)\npython scripts/update-margin.py 0 0 --deposit 5\n\n# Remove $3 collateral (increases leverage)\npython scripts/update-margin.py 0 0 --withdraw 3\n\nMarket Research\n# Get current price + analysis\npython scripts/market-info.py ETH\n\n# Compare multiple assets\npython scripts/market-info.py ETH BTC SOL\n\nIntegration with Other Skills\nBankr (Optional)\nCan use Bankr for market research\nAvantis for actual trade execution\nKeep separate for now (different wallets)\nContinuous Learning\nTrack successful strategies in instincts/crypto/\nNote leverage levels that work\nDocument entry/exit patterns\nStrategic Compact\nCheckpoint after closing positions\nReview performance during checkpoints\nAdjust strategy based on results\nResources\nPlatform: https://avantisfi.com\nSDK Docs: https://sdk.avantisfi.com\nTrading Guide: https://docs.avantisfi.com\nDiscord: https://discord.gg/avantis\nScripts Reference\n\nAll scripts in skills/avantis/scripts/:\n\npositions.py - View open positions\ntrade.py - Open new position\nclose.py - Close position (full or partial)\nupdate-tpsl.py - Update take profit / stop loss\nupdate-margin.py - Add/remove collateral\nmarket-info.py - Get market data\nbalance.py - Check wallet balances\nInstallation\n\nThe SDK is already installed in /home/ubuntu/clawd/avantis_venv/:\n\n# Activate venv (if needed for manual testing)\nsource /home/ubuntu/clawd/avantis_venv/bin/activate\n\n# Check installation\npython -c \"from avantis_trader_sdk import TraderClient; print('✓ SDK ready')\"\n\nSafety Checklist\n\nBefore every trade:\n\n Check wallet balance (USDC + gas)\n Verify leverage is appropriate\n Set stop loss\n Confirm position size meets minimum\n Understand max loss scenario\n Have exit plan ready\n\n⚠️ Important: Leverage trading is high risk. Start small, use stop losses, never risk more than you can afford to lose."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/droppingbeans/avantis-skill",
    "publisherUrl": "https://clawhub.ai/droppingbeans/avantis-skill",
    "owner": "droppingbeans",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}