DeFi Yield Monitor

Monitor DeFi lending and savings positions across Aave v3, SparkLend, Spark Savings, and Kamino with balances, APYs, health factors, and yield tracking.

Self-contained skill for cross-chain DeFi position & yield monitoring. All data from public endpoints — no API keys needed.

First-Time Setup

Run the setup script to clone the project, create venv, and init config:

bash <skill_dir>/scripts/setup.sh

Then edit the config with wallet addresses:

$EDITOR ~/.openclaw/workspace/projects/defi-yield-monitor/config/config.json

Config Template

{
  "wallets": {
    "evm": ["0xYourEthWallet"],
    "solana": ["YourSolanaWallet"]
  },
  "protocols": [
    { "chain": "eth", "name": "aave" },
    { "chain": "bsc", "name": "aave" },
    { "chain": "eth", "name": "spark" },
    { "chain": "eth", "name": "spark_savings" },
    { "chain": "solana", "name": "kamino" }
  ],
  "thresholds": {
    "min_health_factor": 1.25,
    "max_daily_drawdown_pct": 5
  }
}

Remove protocols you don't use. Only include chains where you have positions.

Commands

Use the run script (auto-detects proxy):

# Daily report — positions + risk alerts
bash <skill_dir>/scripts/run.sh --text

# Yield summary — 7d/30d PnL + per-protocol APY
bash <skill_dir>/scripts/run.sh --yield-summary

# JSON output — for programmatic use
bash <skill_dir>/scripts/run.sh --json

Or run directly:

cd ~/.openclaw/workspace/projects/defi-yield-monitor
.venv/bin/python main.py --config config/config.json --yield-summary

Automated Daily Reports

Create an OpenClaw cron job to collect snapshots and report yields:

• Schedule: twice daily (e.g. 13 9,21 * * *)
• Command: bash <skill_dir>/scripts/run.sh --yield-summary
• Delivery: announce to user's Telegram/Discord

After 7 days of snapshots, --yield-summary shows actual realized returns (not just APY estimates).

Supported Protocols

Protocol	Chains	What It Tracks
Aave v3	ETH, BSC	Supply/borrow, APY, health factor
SparkLend	ETH, Base	Supply/borrow, health factor
Spark Savings	ETH	spUSDC/spUSDT/sUSDS vault yields
Kamino	Solana	Lending obligations, APY

Output Fields

• Per position: chain, protocol, wallet, supplied_usd, borrowed_usd, net_value_usd, apy_supply, apy_borrow, health_factor
• Yield summary: current APY per protocol, 7d/30d PnL (absolute + %), annualized APY from actual returns
• Risk alerts: health factor below threshold, daily drawdown exceeding limit

Proxy

The run script auto-detects QuickQ/Clash/V2Ray proxies. To set manually:

export https_proxy=http://127.0.0.1:10020
export http_proxy=http://127.0.0.1:10020

Source

https://github.com/reed1898/defi-yield-monitor