💰 Wallet Tracker CLI

Multi-chain crypto wallet balance tracker for your terminal. Track ETH, SOL, BTC, Polygon, Arbitrum and ERC-20 token balances — all from one command.

Features

• Multi-chain support: Ethereum, Solana, Bitcoin, Polygon, Arbitrum
• ERC-20 tokens: Automatically checks USDT, USDC, DAI, WETH balances
• USD valuations: Real-time price data from CoinGecko
• Portfolio view: Track multiple wallets with total USD value
• Watch mode: Auto-refresh at custom intervals
• JSON output: Pipe-friendly for scripts and dashboards
• Config file: Save wallets for quick access
• Zero dependencies: Pure Node.js, no npm install needed

Quick Start

# Track any address
node index.js 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045

# Track multiple addresses
node index.js 0x742d...1234 3Tcij...DQjUn

# JSON output
node index.js 0x742d...1234 --json

# Watch mode (refresh every 30 seconds)
node index.js 0x742d...1234 --watch 30

Usage

wallet-tracker <address> [address2...]     Track specific addresses
wallet-tracker --add <address> [name]      Save address to config
wallet-tracker --list                      Show saved addresses
wallet-tracker --remove <address>          Remove saved address
wallet-tracker --all                       Check all saved addresses
wallet-tracker --watch [interval]          Watch mode (default: 60s)
wallet-tracker --json                      Output as JSON

Options

Flag	Description
--no-tokens	Skip ERC-20 token checks
--no-price	Skip USD price lookup
--chain <name>	Only check specific chain (eth, sol, btc, polygon, arbitrum)
--json	Machine-readable JSON output
--watch [sec]	Continuous monitoring mode

Supported Chains

Chain	Native Token	Auto-detected
Ethereum	ETH	✅ (0x... addresses)
Polygon	MATIC	✅ (0x... addresses)
Arbitrum	ETH	✅ (0x... addresses)
Solana	SOL	✅ (base58 addresses)
Bitcoin	BTC	✅ (1.../3.../bc1... addresses)

ERC-20 Tokens (Ethereum)

Automatically checked for EVM addresses:

• USDT (Tether)
• USDC (USD Coin)
• DAI (MakerDAO)
• WETH (Wrapped Ether)

Examples

Track a DeFi portfolio

# Save your wallets
node index.js --add 0xYourEthAddress "Main ETH"
node index.js --add 3YourSolAddress "SOL Staking"

# Check all at once
node index.js --all

Monitor in real-time

# Refresh every 30 seconds
node index.js --all --watch 30

Pipeline integration

# Get total USD value
node index.js 0xAddr --json | jq '[.[].usd_value // 0] | add'

# Alert on balance changes
node index.js 0xAddr --json --no-price | jq '.[0].balance'

How it works

• Uses public RPC endpoints (no API keys needed)
• Ethereum: eth.llamarpc.com, ankr, publicnode
• Solana: mainnet-beta.solana.com
• Bitcoin: blockchain.info, blockstream.info
• Prices: CoinGecko free API

Requirements

• Node.js 16+
• No dependencies

License

MIT

---

💖 Support

If this tool is useful, consider donating:

• ETH: 0xa977ED7922703Bf4F9A14cFd27c56d3Cc571908C
• SOL: 3TcijsNw7kL97QmaLHNE8gDeKt177w4PsJd8XMWDQjUn