DeFi Yield Monitor

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