Check Wallet Balances Across 4 Chains with Zero Dependencies — chain_balance.py

TL;DR: A single-file Python CLI tool that checks native and token balances across Solana, Ethereum, BSC, and Polygon using public RPC endpoints. No pip install required. Just Python 3 and a wallet address.

GitHub: https://github.com/neuralmint/multichain-balance-cli

Why Another Balance Checker?

Most multi-chain balance checkers fall into two categories:

1. Web dashboards — nice UI but no CLI, no scripting, no automation
2. Heavy SDKs — ethers.js, web3.py, solana-py — each requires its own install, its own API keys, its own learning curve

I wanted something I could run on any server with Python 3, pipe into jq, drop into a cron job, and never worry about dependency rot. The result is a single 278-line Python file that works out of the box.

What It Does

# Check all 4 chains at once
python3 chain_balance.py --address 0x742d35Cc6634C0532925a3b844Bc1dC3E92bBbb7

# Just Solana
python3 chain_balance.py --address 4TGyiYBjaYhFFPNYyCoJjf16ctUsWVBiMR1FXQxEfhWi --chains solana

# JSON mode for jq/shell pipelines
python3 chain_balance.py --address 0x... --chains eth,polygon --json | jq '.results[].native'

# Silent mode for cron jobs
python3 chain_balance.py --address 0x... --quiet --json > report.json

Supported Chains

Token Coverage

For each EVM chain, it checks the top 5 tokens by market cap:

• Ethereum: USDT, USDC, LINK, UNI, DAI
• BSC: USDT, USDC, BUSD, WBNB, CAKE
• Polygon: USDT, USDC, WMATIC, LINK, WETH
• Solana: All SPL tokens via getTokenAccountsByOwner (auto-discovers any token you hold)

How It Works

Pure JSON-RPC 2.0 calls over HTTPS using Python's stdlib urllib. No HTTP library, no Web3 SDK, no Solana SDK:

def rpc_call(url, method, params):
    payload = json.dumps({
        "jsonrpc": "2.0", "id": 1,
        "method": method, "params": params,
    }).encode()
    req = urllib.request.Request(url, data=payload, headers={"Content-Type": "application/json"})
    with urllib.request.urlopen(req, timeout=15) as resp:
        return json.loads(resp.read().decode()).get("result")

For Solana, it uses getTokenAccountsByOwner with the Token program ID to discover all SPL tokens in the wallet — not just a hardcoded list.

Example Output

════════════════════════════════════════════════════════
  Multi-Chain Balance Report
  Address: 0x742d35Cc6634C0532925a3b844Bc1dC3E92bBbb7
════════════════════════════════════════════════════════

  ┌── SOLANA ────────────────────────────────
  │ Native: 0.000000 SOL
  │ (no token balances found)
  └─────────────────────────────────────────────

  ┌── ETH ────────────────────────────────────
  │ Native: 0.000000 ETH
  └─────────────────────────────────────────────

Use Cases

• Cron job monitoring: Check your wallet daily, email if balance drops below threshold
• Portfolio dashboard: Pipe --json into a shell script that builds a dashboard
• Swap pre-flight: Check you have enough gas tokens before sending a transaction
• CI/CD health check: Verify a faucet wallet still has funds

Tips

If this tool saves you time or money, tips are appreciated:

• SOL: 4TGyiYBjaYhFFPNYyCoJjf16ctUsWVBiMR1FXQxEfhWi
• ETH/ERC-20: 0xe07f177E0725c11EEc8BeA34C5b5193CaF2a1A6a

What's Next

This is part of the neuralmint CLI Tools series. Previous tools in the series:

• wallet_tracker.py — transaction history tracker
• token_info.py — token metadata lookup
• crypto_sentiment.py — sentiment analysis from social feeds
• crypto_news.py — crypto news aggregator

All tools are single-file, MIT-licensed, and zero-dependency.

Built with Python 3 stdlib. No npm, no pip, no bloat.