Optimizing Staking Rewards

Overview

Analyze staking opportunities across PoS blockchains and liquid staking protocols. Compares APY/APR, calculates net yields after fees, assesses protocol risks, and recommends optimal allocations.

Prerequisites

1. Python 3.8+ installed
2. Dependencies: pip install requests
3. Network access to DeFiLlama APIs
4. Optional: CoinGecko API key for higher rate limits

Instructions

1. Compare staking options for a specific asset:

```bash
python ${CLAUDESKILLDIR}/scripts/staking_optimizer.py --asset ETH
```
Shows protocol name, type (native vs liquid), gross/net APY, risk score, TVL, and lock-up period.

1. Analyze with position size for gas-adjusted yields:

```bash
python ${CLAUDESKILLDIR}/scripts/staking_optimizer.py --asset ETH --amount 10
```
Calculates effective APY accounting for gas costs and projects returns at 1M, 3M, 6M, and 1Y.

1. Optimize existing portfolio with current positions:

```bash
python ${CLAUDESKILLDIR}/scripts/staking_optimizer.py --optimize \
--positions "10 ETH @ lido 4.0%, 100 ATOM @ native 18%, 50 DOT @ native 14%"
```
Suggests higher-yield alternatives with projected improvement and switching costs.

1. Compare protocols or run risk assessment:

```bash
python ${CLAUDESKILLDIR}/scripts/staking_optimizer.py --compare --protocols lido,rocket-pool,frax-ether
python ${CLAUDESKILLDIR}/scripts/staking_optimizer.py --asset ETH --detailed
```

1. Export results in JSON or CSV:

```bash
python ${CLAUDESKILLDIR}/scripts/staking_optimizer.py --asset ETH --format json --output staking.json
```

Output

Comparison table ranked by risk-adjusted return (Net APY multiplied by Risk Score / 10), showing native and liquid staking options:

  STAKING OPTIONS FOR ETH                              2025-01-15 15:30 UTC  # 2025 timestamp
  Protocol        Type      Gross APY  Net APY  Risk   TVL         Unbond
  Frax (sfrxETH)  liquid      5.10%     4.59%   7/10   $450M       instant
  Lido (stETH)    liquid      4.00%     3.60%   9/10   $15B        instant
  Rocket Pool     liquid      4.20%     3.61%   8/10   $3B         instant
  Coinbase cbETH  liquid      3.80%     3.42%   9/10   $2B         instant
  ETH Native      native      4.00%     4.00%   10/10  $50B        variable

Error Handling

See ${CLAUDE_SKILL_DIR}/references/errors.md for comprehensive error handling.

Examples

Common staking analysis workflows from single-asset comparison to full portfolio optimization:

# Quick ETH staking comparison
python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --asset ETH

# Large position with full risk analysis
python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --asset ETH --amount 100 --detailed

# Multi-asset comparison exported to CSV
python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --assets ETH,SOL,ATOM --format csv

# Portfolio optimization with current positions
python ${CLAUDE_SKILL_DIR}/scripts/staking_optimizer.py --optimize \
  --positions "50 ETH @ lido 3.6%, 500 SOL @ marinade 7.5%"  # 500 - minimum stake amount in tokens

Resources

• ${CLAUDE_SKILL_DIR}/references/implementation.md - Optimization reports, risk assessment details, disclaimers
• ${CLAUDE_SKILL_DIR}/references/errors.md - Comprehensive error handling
• DeFiLlama Yields: https://defillama.com/yields
• StakingRewards: https://www.stakingrewards.com
• Lido: https://lido.fi | Rocket Pool: https://rocketpool.net