aeon-defi-monitor · diff

git:20260512.574b491 to git:20260512.a4ba040

31 added, 120 removed. Audit A to A.

---

name: aeon-defi-monitor

description: |

- Check pool health, position state, and yield rates for tracked DeFi protocols on Base, Arbitrum,

- Optimism, Ethereum, and other EVM chains. Watchlist-driven — surfaces only meaningful changes in

- TVL, fee APR, incentive APR, utilization, or your own position values. Use to track lending

- exposure, LP positions, vault deposits, or protocols you'd want to enter on a drawdown.

- Triggers: "check my defi positions", "monitor these pools", "pool health for X",

- "yield check on Aave/Compound/...", "is my LP underwater".

+ Watchlist monitor for DeFi pools, lending markets, and vaults. Surfaces only changed entries —

+ APR floor breached, utilization ceiling hit, TVL delta above threshold, health factor approaching

+ liquidation, or position PnL crossed your alert. Bankr-ready Submit payload attached when an

+ alert recommends action. Silent on quiet members.

+ Triggers: "check my defi positions", "monitor these pools", "yield check on Aave/Compound",

+ "is my LP underwater", "pool health for X".

---

# aeon-defi-monitor

- Watchlist monitor over DeFi pools, lending markets, and vaults. Pulls live data from DefiLlama + on-chain RPC, computes deltas vs prior run, surfaces only changed entries.

- Designed to **execute on alerts via Bankr** when you want to act — e.g., add to an LP that just crossed your APR floor, or unwind a lending position whose utilization spiked.

+ Tracks a configured list of DeFi entries — DEX pools, lending positions, vault deposits — and pings on meaningful change. Designed to pair with Bankr Submit so the operator can act directly on alerts.

- ## Watchlist format

+ ## Watchlist

```yaml

protocols:

- - id: "aerodrome-base"

+ - id: aerodrome-base

type: dex

- pool_address: "0x..."

- alert_apr_floor: 8.0 # ping if APR drops below

- alert_tvl_delta_pct: 20 # ping on ≥20% TVL change in 24h

- - id: "aave-v3-base"

- type: lending

- market_address: "0x..."

- asset: "USDC"

- alert_util_ceiling: 85 # ping if utilization > 85%

+ pool_address: 0x...

+ alert_apr_floor: 8.0

+ alert_tvl_delta_pct: 20

- - id: "morpho-base-usdc"

+ - id: aave-v3-base-usdc

type: lending

- asset: "USDC"

- position_address: "0x..." # your own EOA / safe

- alert_pnl_delta_usd: 100

+ market_address: 0x...

+ asset: USDC

+ position_address: 0x... # optional — your EOA / safe

+ alert_util_ceiling: 85

+ alert_health_factor: 1.3 # ping if borrow position approaches liquidation

- - id: "pendle-arb-pt-eeth"

+ - id: pendle-arb-pt-eeth

type: vault

- market_id: "..."

+ market_id: ...

position_size_usd: 5000

alert_implied_apy_floor: 12.0

```

## Per-type checks

- ### `dex` (LP positions, pool health)

- - TVL (current + 24h delta).

- - 24h volume and fee APR.

- - Incentive APR + emission token (if any).

- - Pool composition (impermanent loss exposure if your position is tracked).

- - Slippage estimate on a $1k swap (liquidity sanity check).

- ### `lending` (Aave / Compound / Morpho / Spark)

- - Total supplied / borrowed.

- - Utilization rate.

- - Current supply APY (real + incentive split).

- - Current borrow APY.

- - If a position address is configured: position health factor, collateral value, borrow value.

- ### `vault` (Pendle / Yearn / Beefy / Idle / etc.)

- - Vault TVL.

- - Implied APY (and what drives it — underlying yield vs leverage vs incentives).

- - Position value if `position_address` configured.

- - Withdrawal liquidity check (can you exit at size?).

- ## Data sources

- ```bash

- # DefiLlama protocol detail

- curl -s "https://api.llama.fi/protocol/${protocol_slug}"

- # DefiLlama yields

- curl -s "https://yields.llama.fi/pools" | jq '.data[] | select(.pool == "${pool_id}")'

- # On-chain reads via Bankr-compatible RPC

- curl -s -X POST "${RPC_URL}" \

- -H "Content-Type: application/json" \

- -d '{"jsonrpc":"2.0","id":1,"method":"eth_call","params":[{"to":"${pool_addr}","data":"0x..."}, "latest"]}'

- # Aave v3 user data (via Pool contract)

- # Pendle PT/YT pricing (via Pendle API)

- curl -s "https://api-v2.pendle.finance/core/v1/${chain_id}/markets/${market_id}"

- ```

+ - **DEX** — TVL + 24h delta, fee APR + incentive APR + emission token, slippage estimate on $1k swap.

+ - **Lending** — total supplied / borrowed, utilization, supply + borrow APYs split by real vs incentive, health factor if a position is tracked.

+ - **Vault** — TVL, implied APY (with what drives it), position value if tracked, withdrawal liquidity.

## Alert triggers

- A watchlist entry surfaces if any:

- | Trigger | Applies to |

- |---|---|

- | APR drops below floor | DEX, vault |

- | Utilization above ceiling | Lending |

- | TVL delta above threshold | All |

- | Position PnL change above threshold | If position address tracked |

- | Health factor approaching 1.0 | Lending (your borrow side) |

- | Pool depegs (asset ratio shifts > 1%) | DEX with stable/stable or LST pairs |

- | Vault implied APY drops below floor | Vault |

- Silent on unchanged.

- ## Output

- ```

- *DeFi Monitor — 2026-05-12*

- 3 watchlist entries surfaced (5 silent)

- aerodrome-base (DEX) — pool 0x...

- TVL: $42M (▼ 14% 24h — large LP exit)

- Fee APR: 18.2% (▲ — same fees, smaller LP base)

- Incentive APR: 4.1% (AERO emissions, unchanged)

- Slippage @ $1k: 0.04% (fine)

- Action: APR is up but TVL exit may continue — wait for stabilization before adding

+ APR drops below floor, utilization above ceiling, TVL delta above threshold, position PnL crossed threshold, health factor approaches 1.0, pool depegs > 1%, vault APY drops below floor. Health-factor alerts always fire when approaching 1.0 regardless of other thresholds.

- aave-v3-base USDC (Lending) — market 0x...

- Util: 87% (▲ from 76%) — ceiling breached

- Supply APY: 9.1% (real 7.8% + incentives 1.3%)

- Borrow APY: 11.2%

- Risk: if util hits 95% you'll have withdrawal queue on the supply side

+ ## Sources

- morpho-base-usdc (Lending) — your position 0x...

- Position: $5,420 supplied (was $5,300, +$120 PnL — yield accrual)

- No alert triggered (PnL delta below $1k threshold) — surfaced anyway because of paired aave alert

- ```

+ DefiLlama (`api.llama.fi` + `yields.llama.fi`), on-chain via Bankr-compatible RPC / Quicknode / Alchemy. Position data sanity-checked vs on-chain state every run.

## Bankr execution hook

- When an alert recommends action (add LP, unwind position, rebalance), the output includes a Bankr-ready Submit payload. Operator copies into agent input:

+ When an alert recommends action, output includes a ready-to-paste Submit payload:

```

Submit: deposit 1000 USDC into aerodrome-base pool 0x... via Aerodrome router

Submit: withdraw position from aave-v3-base USDC market 0x...

```

- ## Guardrails

- - Read-only by default. Execution requires explicit operator input — the monitor never auto-rebalances.

- - Position data is sanity-checked vs on-chain state every run (no trust in indexer alone).

- - Stale-data flag if last update > 1 hour old.

- - Health-factor alerts always fire when approaching 1.0, regardless of other thresholds.

- ## Required keys

- - Bankr-compatible RPC (or Quicknode / Alchemy / public RPC).

- - Optional Bankr Wallet API key if tracking position addresses owned by the operator.

- ## Pairs with

+ ## Rules

- - `aeon-defi-overview` (the regime context this monitor operates within).

- - `aeon-on-chain-monitor` (counterparty / treasury activity behind your protocols).

- - Bankr Submit / Trails / Zyfai for execution.

+ - Read-only by default. Execution requires explicit operator input.

+ - Silent on unchanged.

+ - Stale-data flag if last update > 1h old.