backtrader
Event-driven backtesting with bar-by-bar execution, complex order types, multiple analyzers,…
DeFi yield evaluation including fee APR, real vs nominal yield, net APY after costs, and yield sustainability analysis
$ npx -y skills add agiprolabs/claude-trading-skills --skill yield-analysis --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/yield-analysisContext preview
The summary Claude sees to decide when to auto-load this skill.
DeFi yield evaluation including fee APR, real vs nominal yield, net APY after costs, and yield sustainability analysis
name: yield-analysis description: DeFi yield evaluation including fee APR, real vs nominal yield, net APY after costs, and yield sustainability analysis
DeFi yields are often misleading. A pool advertising 200% APY may deliver negative real returns once you account for impermanent loss, gas costs, and emission token depreciation. This skill provides the framework to decompose, evaluate, and compare yield opportunities accurately.
Most DeFi yield dashboards show **nominal** yield — the headline number. Real yield requires decomposing that number into its components and subtracting all costs. Without this decomposition:
Every DeFi yield breaks down into one or more of these sources:
Swap fees earned by liquidity providers. This is the most sustainable yield source because it comes from real economic activity.
fee_apr = (daily_volume * fee_rate / tvl) * 365 your_daily_fees = daily_volume * fee_rate * (your_liquidity / total_liquidity)
For CLMM pools (concentrated liquidity), fee income is amplified by how tightly you concentrate your range. See the `lp-math` skill for CLMM mechanics.
Protocol reward tokens distributed to LPs. Often the largest component of advertised yields, but frequently unsustainable.
emission_apr = (daily_emission_tokens * token_price * 365) / tvl
The critical question: will the emission token hold its value? If everyone farms and dumps, the token depreciates and actual USD yield is much lower.
Interest earned from lending protocol deposits (Marginfi, Kamino, Solend). Driven by borrowing demand — more sustainable than emissions but fluctuates with utilization.
Validator staking yield (~7% APR on Solana) or liquid staking token (LST) yield. The baseline risk-free rate for the Solana ecosystem.
| Metric | What It Includes | What It Ignores | |--------|-----------------|-----------------| | Nominal APY | Fee APR + emission APR (compounded) | IL, gas, depreciation, risk | | Real Yield | Everything, net of all costs | Nothing — this is the true return |
real_yield = fee_apr
+ emission_apr × (1 - emission_depreciation)
- il_cost
- gas_cost
- rebalancing_costWhere:
Nominal APY displayed: 45% Decomposition: Fee APR: 18% Emission APR: 30% (RAY token rewards) Emission depreciation: 40% (RAY down 40% over 30d) Effective emission: 18% (30% × 0.6) IL cost (estimated): 12% (SOL volatile against USDC) Gas + rebalance: 1% Real yield = 18% + 18% - 12% - 1% = 23%
The 45% nominal yield is really 23% after accounting for all factors.
fee_apr = fee_rate * daily_volume / tvl * 365
For a pool with 0.25% fee rate, $2M daily volume, and $10M TVL:
fee_apr = 0.0025 * 2_000_000 / 10_000_000 * 365 = 18.25%
CLMM fee income depends on your position range relative to trading activity:
# Simplified — see lp-math skill for full CLMM math fee_apr = fee_rate * daily_volume_in_range / position_liquidity * 365
Tighter ranges earn higher fees per dollar deployed but go out of range more frequently, requiring rebalancing.
your_share = your_liquidity / total_pool_liquidity your_daily_fees = total_daily_fees * your_share
1. Protocol launches with high emission rewards → attracts LPs 2. TVL grows → yield per LP drops → protocol increases emissions 3. LPs farm and dump emission tokens → token price drops 4. Lower token price → lower USD-denominated yield 5. LPs leave → TVL drops → protocol increases emissions further 6. Spiral continues until emissions stop or protocol fails
# Protocol P/E ratio pe_ratio = fully_diluted_valuation / annual_protocol_revenue # Revenue-to-emission ratio (> 1.0 is sustainable) sustainability = annual_revenue / annual_emission_value # Token velocity (high = lots of sell pressure) velocity = daily_emission_selling / daily_token_volume
**Interpretation:**
When comparing yield opportunities, normalize across these dimensions:
Compare like for like. For SOL:
| Strategy | Expected APR | Risk Level | IL Exposure | |----------|-------------|------------|-------------| | Native staking | ~7% | Low | None | | Liquid staking (mSOL) | ~7.5% | Low | Minimal | | SOL-USDC LP
A comprehensive collection of 68 ready-to-use trading, DeFi, and quantitative finance Agent Skills. Works with Claude Code, Cursor, Codex, Gemini CLI, and 30+ other tools.
Repo: agiprolabs/claude-trading-skills
Event-driven backtesting with bar-by-bar execution, complex order types, multiple analyzers,…
Solana token market data via Birdeye — prices, OHLCV, trades, token metadata, security…
Broad crypto market data from CoinGecko covering 13,000+ tokens. Global market stats,…
Cointegration testing for pairs trading using Engle-Granger, Johansen, and rolling stability…
Wallet evaluation, monitoring, and copy-trade strategy design for Solana DEX trading
Cross-asset correlation analysis including rolling correlation, hierarchical clustering, tail…