Kamino Positions Monitor

Kamino Positions Monitor

Monitors Solana wallets with Kamino Lend positions. Outputs a liquidation-focused report with health metrics, SOL liquidation price, and how much to deposit or repay to reach 60% margin.

When to Use

• User asks about Kamino positions, Solana lending, or liquidation risk
• User wants to check fund health or get actionable recommendations
• User mentions "Kamino", "Solana funds", "liquidation", or "DeFi monitoring"

Prerequisites

The kamino-positions-monitor project must be installed and configured. User must provide: Solana wallet addresses in wallets.json. RPC is optional—if SOLANA_RPC_URL is not set, the public Solana mainnet RPC is used (rate-limited; for heavy use, set a dedicated RPC in .env).

1. Clone and install:

   git clone https://github.com/csacanam/kamino-positions-monitor
   cd kamino-positions-monitor && npm install
   

2. Configure: copy wallets.json.example → wallets.json, add wallet addresses. Optional in .env: SOLANA_RPC_URL. When run via OpenClaw, the report is delivered to the user's chat automatically. For direct runs (cron, terminal), optional TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID send the report to a Telegram chat.
3. Project path: directory containing kamino_monitor.js. Set KAMINO_MONITOR_PATH or use . if the workspace is the project.

Run the Monitor

cd "${KAMINO_MONITOR_PATH:-.}" && node kamino_monitor.js wallets.json

Output

Stdout gets the full report. Via OpenClaw, the agent delivers it to the user's chat. When run directly, optional TELEGRAM_* in .env also pushes to a Telegram chat (HTML formatting, Jupiter links).

Example (abbreviated):

📊 Funds Report | 02/22/26, 11:57 PM

📋 GLOBAL SUMMARY
   SOL price: $77.33
   Kamino: Coll $30881 | Debt $10521 | Net $20360
   To bring all to Health 60%: deposit ~$4583 or repay ~$1375
   P_liq of fund most at risk: $46.39 · SOL must drop 40% to reach
   If SOL drops:
     10% (SOL ~$70): deposit $7646 total (+$3047) or repay $2294 total (+$914)
     ...

👛 Fund 1 (Ab12…xyZ9)
   Spot: SOL 0.32 | USDC 0 | USDT 0 → $24.85
   Kamino: Coll $421 | Debt $189 | Net $232 🟢
   LTV 45% | Health 40% | Liq SOL: $46.39 (now $77.33)
   📌 For Health 60%: deposit ~$210 (~2.7 SOL) or repay ~$63
   🔗 https://jup.ag/portfolio/[wallet_address]

Interpreting Results

• 🟢🟡🟠🔴: Risk level (green = healthy, red = near liquidation)
• ⚪: No debt or no Kamino position
• Health ratio 1.0 = at liquidation edge; >1 = safe
• Health % 0% = liquidation; 100% = max margin

See reference.md for formula details.