DeFi Portfolio Tracker

Purpose

Build a complete snapshot of wallet exposure across spot assets, LPs, staking, vaults, and debt positions.

Use this skill when

• The user provides a wallet address / ENS / list of wallets.
• The task is portfolio decomposition, debt health, or exposure review.
• The user asks for net worth, PnL proxy, or risk hot spots.

Do not use this skill when

• The task is protocol-level risk scoring (use defi-risk-evaluator).
• The task is transaction construction/signing.

Workflow

1. Resolve identity inputs (address/ENS) and target chains.
2. Collect balances and position data from preferred portfolio providers.
3. Normalize positions using references/position-schema.md.
4. Calculate totals:
   • Gross assets
   • Gross debt
   • Net worth (assets - debt)
5. Compute risk indicators:
   • Concentration by token and protocol
   • Leverage ratio
   • Borrow health factor buckets (from references/risk-thresholds.md)
6. Return structured output and explicit caveats.

Rules

• Treat all valuation as timestamped snapshots.
• Separate wallet-native spot holdings from DeFi positions.
• Never assume historical PnL unless transaction history is explicitly available.
• Report unknown pricing or illiquid assets separately.

Required output format

{
  "wallet": "string",
  "snapshot_time": "ISO-8601",
  "by_chain": [
    {
      "chain": "string",
      "assets_usd": 0,
      "debt_usd": 0,
      "net_worth_usd": 0,
      "positions": [
        {
          "protocol": "string",
          "position_type": "spot|lp|staking|lending_supply|lending_borrow|vault",
          "asset": "string",
          "amount": 0,
          "value_usd": 0,
          "debt_usd": 0,
          "health_factor": 0
        }
      ]
    }
  ],
  "portfolio_totals": {
    "assets_usd": 0,
    "debt_usd": 0,
    "net_worth_usd": 0,
    "leverage_ratio": 0
  },
  "risk_flags": ["string"],
  "summary": "2-4 sentence summary"
}

Bundled resources

• references/position-schema.md: Canonical position schema.
• references/risk-thresholds.md: Health factor and concentration thresholds.
• scripts/portfolio_summary.py: Deterministic net worth + risk aggregation from normalized position JSON.