optimizing-defi-yields

# Optimizing DeFi Yields ## Overview Find and compare DeFi yield opportunities across protocols. Aggregates data from DeFiLlama and other sources to provide APY/APR comparisons, risk assessments, and optimization recommendations for yield farming strategies. ## Prerequisites Before using this skill, ensure you have: - Python 3.8+ installed - Internet access for API queries - Understanding of DeFi concepts (APY, APR, TVL, impermanent loss) ## Instructions 1. Search for yield opportunities across all chains or filter by a specific chain: ```bash python ${CLAUDE_SKILL_DIR}/scripts/yield_optimizer.py --top 20 python ${CLAUDE_SKILL_DIR}/scripts/yield_optimizer.py --chain ethereum --top 10 ``` 2. Filter by criteria -- minimum TVL (for safety), asset type, or protocol: ```bash python ${CLAUDE_SKILL_DIR}/scripts/yield_optimizer.py --min-tvl 10000000 --top 15 # 10000000 = 10M limit python ${CLAUDE_SKILL_DIR}/scripts/yield_optimizer.py --asset USDC --chain ethereum python ${CLAUDE_SKILL_DIR}/scripts/yield_optimizer.py --protocol aave,compound,curve ``` 3. Apply risk filters -- show only audited protocols or filter by risk level (`--risk low`, `--risk medium`, `--risk high`): ```bash python ${CLAUDE_SKILL_DIR}/scripts/yield_optimizer.py --audited-only --min-tvl 1000000 # 1000000 = 1M limit python ${CLAUDE_SKILL_DIR}/scripts/yield_optimizer.py --risk low --min-apy 3 ``` 4. Analyze specific opportunities -- get detailed pool breakdown or compare protocols: ```bash python ${CLAUDE_SKILL_DIR}/scripts/yield_optimizer.py --pool "aave-v3-usdc-ethereum" --detailed python ${CLAUDE_SKILL_DIR}/scripts/yield_optimizer.py --compare aave,compound,spark --asset USDC ``` 5. Export results to JSON or CSV for further analysis: ```bash python ${CLAUDE_SKILL_DIR}/scripts/yield_optimizer.py --top 50 --format json --output yields.json python ${CLAUDE_SKILL_DIR}/scripts/yield_optimizer.py --chain ethereum --format csv --output eth_yields.csv ``` ## Output ### Yield Summary Table ``` ============================================================================== DEFI YIELD OPTIMIZER 2026-01-15 15:30 UTC # 2026 year ============================================================================== TOP YIELD OPPORTUNITIES ------------------------------------------------------------------------------ Protocol Pool Chain TVL APY Risk Score Convex cvxCRV Ethereum $450M 12.5% Low 9.2 Aave v3 USDC Ethereum $2.1B 4.2% Low 9.8 Curve 3pool Ethereum $890M 3.8% Low 9.5 Compound v3 USDC Ethereum $1.5B 3.2% Low 9.6 Yearn yvUSDC Ethereum $120M 5.1% Medium 7.8 ------------------------------------------------------------------------------ APY BREAKDOWN (Top Result) ------------------------------------------------------------------------------ Base APY: 4.5% Reward APY: 8.0% (CRV + CVX) Total APY: 12.5% IL Risk: None (single-sided) ============================================================================== ``` ### Risk Assessment ``` RISK ANALYSIS: Convex cvxCRV ------------------------------------------------------------------------------ Audit Status: ✓ Audited (Trail of Bits, OpenZeppelin) Protocol Age: 3+ years TVL: $450M (stable) TVL Trend: +5% (30d) Risk Score: 9.2/10 (Low Risk) Risk Factors: • Smart contract dependency on Curve • CRV/CVX reward token volatility • Vote-lock mechanics ============================================================================== ``` ## Error Handling See `${CLAUDE_SKILL_DIR}/references/errors.md` for comprehensive error handling. Common issues: - **API timeout**: Uses cached data with staleness warning - **No pools found**: Broaden search criteria - **Invalid protocol**: Check supported protocols list ## Examples See `${CLAUDE_SKILL_DIR}/references/examples.md` for detailed usage examples. ### Quick Examples **Find stablecoin yields**: ```bash python yield_optimizer.py --asset USDC,USDT,DAI --min-tvl 10000000 # 10000000 = 10M limit ``` **Low-risk opportunities**: ```bash python yield_optimizer.py --risk low --audited-only --min-apy 2 ``` **Multi-chain search**: ```bash python yield_optimizer.py --chain ethereum,arbitrum,polygon --top 20 ``` **Export top yields**: ```bash python yield_optimizer.py --top 100 --format json --output all_yields.json ``` ## Configuration Settings in `${CLAUDE_SKILL_DIR}/config/settings.yaml`: - **Default chain**: Primary chain to search - **Cache TTL**: How long to cache API responses - **Risk weights**: Customize risk scoring factors - **Min TVL default**: Default minimum TVL filter ## Resources - DeFiLlama: https://defillama.com/yields - Yield data source - DeFi Safety: - Protocol security scores - Impermanent Loss Calculator: Understand LP risks