Passive Income Monitor

passive-income-monitor

Version: 1.0.0 Author: mariusfit Category: finance, crypto, automation, passive-income Tags: passive income, crypto, grass, storj, mysterium, defi, staking, yield, monitoring, alerts

What This Does

Monitors multiple passive income streams from a single command. Tracks bandwidth monetization nodes (Grass.io, Mysterium Network), decentralized storage earnings (Storj), DeFi yield positions, and crypto staking rewards. Provides unified dashboard, earnings summaries, and configurable alerts when earnings drop or nodes go offline.

Zero API keys required for basic mode. Optional API keys unlock richer data.

Use Cases

Commands

monitor check — Quick status of all configured streams

bash passive-income-monitor.sh check

monitor earnings — Detailed earnings report

bash passive-income-monitor.sh earnings [--days 7] [--format json|table|csv]

monitor add — Add income stream

bash passive-income-monitor.sh add grass "node1" --wallet 0xABC...
bash passive-income-monitor.sh add storj "storage1" --api-key KEY --node-id NODE_ID
bash passive-income-monitor.sh add mysterium "node1" --rpc http://localhost:4449
bash passive-income-monitor.sh add defi "aave-usdc" --protocol aave --address 0xABC... --chain ethereum
bash passive-income-monitor.sh add staking "eth-validator" --address 0xABC... --chain ethereum

monitor remove — Remove income stream

bash passive-income-monitor.sh remove "node1"

monitor alert — Set alert thresholds

bash passive-income-monitor.sh alert --min-daily 5.00 --notify-offline --email user@example.com

monitor export — Export earnings history

bash passive-income-monitor.sh export --format csv --output earnings-2026.csv

monitor dashboard — Live terminal dashboard (ncurses-style)

bash passive-income-monitor.sh dashboard

Supported Platforms

| Platform | Type | API | Notes | |----------|------|-----|-------| | Grass.io | Bandwidth | Public API | Wallet address required | | Mysterium Network | Bandwidth | Local RPC | Node must be running | | Storj | Storage | API Key | DCS node API | | Aave v3 | DeFi Lending | Public on-chain | No key needed | | Compound v3 | DeFi Lending | Public on-chain | No key needed | | Lido | ETH Staking | Public API | Staking address | | Ethereum Staking | Validator | Beaconcha.in API | Validator pubkey | | Helium | IoT Network | Public API | Wallet address |

Configuration

Config stored in ~/.config/passive-income-monitor/config.json:

{
  "streams": [
    {
      "name": "grass-node1",
      "type": "grass",
      "wallet": "0xABC...",
      "enabled": true
    },
    {
      "name": "mysterium-node",
      "type": "mysterium",
      "rpc": "http://localhost:4449",
      "enabled": true
    }
  ],
  "alerts": {
    "min_daily_usd": 5.00,
    "notify_offline": true,
    "notify_method": "file"
  },
  "currency": "USD"
}

Alert Methods

Output Examples

╔═══════════════════════════════════════════════════════════════╗
║          PASSIVE INCOME MONITOR — 2026-02-24                  ║
╠═══════════════════════════╦═══════════╦══════════╦═══════════╣
║ Stream                    ║ Status    ║ 24h      ║ 7d Total  ║
╠═══════════════════════════╬═══════════╬══════════╬═══════════╣
║ grass-node1               ║ ✅ Online  ║ $0.34    ║ $2.18     ║
║ mysterium-residential     ║ ✅ Online  ║ $0.12    ║ $0.84     ║
║ storj-node                ║ ⚠️ Offline ║ $0.00    ║ $1.92     ║
║ aave-usdc-pos             ║ ✅ Earning ║ $0.28    ║ $1.96     ║
║ lido-staking              ║ ✅ Active  ║ $0.45    ║ $3.15     ║
╠═══════════════════════════╬═══════════╬══════════╬═══════════╣
║ TOTAL                     ║           ║ $1.19    ║ $10.05    ║
╚═══════════════════════════╩═══════════╩══════════╩═══════════╝
⚠️  ALERT: storj-node has been offline >2h. Check node health.
📈 Projected monthly: $35.70 (based on 7d average)

Requirements

Installation

# Via OpenClaw
clawhub install passive-income-monitor
Manual
bash install.sh

Notes

Config stored in ~/.config/passive-income-monitor/config.json:

{
  "streams": [
    {
      "name": "grass-node1",
      "type": "grass",
      "wallet": "0xABC...",
      "enabled": true
    },
    {
      "name": "mysterium-node",
      "type": "mysterium",
      "rpc": "http://localhost:4449",
      "enabled": true
    }
  ],
  "alerts": {
    "min_daily_usd": 5.00,
    "notify_offline": true,
    "notify_method": "file"
  },
  "currency": "USD"
}