COMMAND
Check wallet balances from the terminal
glnc balance queries one or more wallets across the supported chains and prints a per-chain breakdown with USD values. ENS names resolve automatically. Pass multiple addresses for a portfolio. Add --watch for a live dashboard with deltas.
Synopsis
glnc balance <address|ens>... [flags]Address auto-detection
glnc detects the chain from the address format. No --chain flag is required for single-chain queries; pass it only to narrow a query to one specific chain.
| Flag | Description |
|---|---|
0x + 40 hex | All EVM chains (Ethereum, Polygon, Arbitrum, Base, Optimism, Linea, zkSync) |
*.eth, *.xyz | ENS name; resolved to an EVM address before query |
bc1... | Bitcoin bech32 SegWit address |
1... or 3... | Bitcoin legacy address |
base58, 32–44 chars | Solana address |
Examples
EVM address:
glnc balance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045Multi-wallet portfolio (per-wallet tables plus a grand total):
glnc balance vitalik.eth 0xABC...123 bc1q...xyzWatch mode runs in the terminal's alternate screen buffer, so on Ctrl+C your scrollback is restored exactly as it was. Deltas show in green and red.
glnc balance 0xd8dA... --watch --interval 30Flags
| Flag | Description |
|---|---|
--chain <name> | Query a single chain instead of auto-detecting from the address. |
--watch / -w | Re-poll on an interval. Shows deltas in place using the alternate screen buffer. |
--interval <N> | Watch interval in seconds. Default 15. |
--positions / -p | Include DeFi positions: Aave V3 health factor, Uniswap V3 LP NFTs. |
--nfts / -n | Include top NFT collections per chain via Reservoir (EVM only). |
--show-unpriced | Show tokens with no known USD price (hidden by default for EVM ERC-20 dust). |
--verbose / -v | Show full addresses instead of the 0x….1234 short form. |
--json | Emit the glnc.balance/v1 envelope on stdout. NDJSON when combined with --watch. |
--strict | Exit 3 on a partial result (one-shot); abort on the first fetch exception (watch). |
JSON envelope
Under --json, balance emits a single document with schema id glnc.balance/v1. Under --watch --json it emits NDJSON with schema glnc.balance.watch/v1, one envelope per poll. See the JSON envelope reference for the full shape.
glnc balance vitalik.eth --json | jq '.data.totalUsd'Token discovery
EVM token discovery uses the Uniswap default token list (~1,400 tokens per chain), cached at ~/.glnc/token-cache.json with a 24h TTL. Tokens not on the list are not shown; true full discovery would require an archive node or a paid indexer. Solana uses getTokenAccountsByOwner which discovers all SPL tokens natively.
Dust filter: tokens priced below $1.00 USD are hidden. Tokens with unknown prices are shown with — in the USD column.