Wallet Tracker

Track SOL and ETH wallet balances from the command line. Supports multiple addresses, JSON output, and USD conversion via CoinGecko.

Features

• Solana (SOL) — check any SOL address balance via public RPC
• Ethereum (ETH) — check any ETH address balance via Etherscan API
• Multi-address — pass any mix of SOL and ETH addresses in one command
• USD value — live SOL/USD price from CoinGecko (auto-fetched when SOL addresses are present)
• JSON output — machine-readable output with --json for scripting
• No dependencies — uses only Python 3 stdlib (urllib, json, argparse)

Requirements

• Python 3.7+
• For ETH lookups: an Etherscan API key (free tier works)

Installation

# Download the script
curl -O https://raw.githubusercontent.com/neuralmint/wallet-tracker/main/wallet_tracker.py
chmod +x wallet_tracker.py

# Or clone the repo
git clone https://github.com/neuralmint/wallet-tracker.git
cd wallet-tracker

Usage

Check a Solana address

./wallet_tracker.py <SOLANA_ADDRESS>

Check an Ethereum address (with Etherscan API key)

./wallet_tracker.py --etherscan-key YOUR_API_KEY 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

Or set the key via environment variable:

export ETHERSCAN_API_KEY=your_key_here
./wallet_tracker.py 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

Check multiple addresses at once (mixed chains)

./wallet_tracker.py <SOL_ADDR_1> <SOL_ADDR_2> 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

JSON output (for scripts)

./wallet_tracker.py --json <SOL_ADDRESS> 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

Example JSON response:

[
  {
    "address": "7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtVq",
    "chain": "solana",
    "balance_raw": 2.5412,
    "balance": "2.5412 SOL",
    "usd_value": 380.96,
    "usd_value_fmt": "$380.96",
    "usd_price": 149.87
  }
]

Help

./wallet_tracker.py --help

Output

Human-readable output uses a bordered table layout:

┌─────────────────────────────────────────────────────────────────┐
│                  Wallet Portfolio Tracker                       │
├─────────────────────────────────────────────────────────────────┤
│ SOL/USD: $149.87                                                │
├─────────────────────────────────────────────────────────────────┤
│ [SOLANA] 7EcDhS...CFLtVq  2.5412 SOL                           │
│   ≈ $380.96                                                      │
│ [ETH]    0x742d...f44e    0.0423 ETH                            │
└─────────────────────────────────────────────────────────────────┘

License

MIT