Checking USDC Balance
Use npx agnic@latest balance to check USDC balance across supported networks.
Authentication
Run npx agnic@latest status --json to verify. If not authenticated:
- Headless (CI/server/agent): Set
AGNIC_TOKENenv var or pass--token <token> - Interactive (has browser): Run
npx agnic@latest auth login
See the authenticate-wallet skill for details.
Command Syntax
npx agnic@latest balance [--network <network>] [--json]
Options
| Option | Description |
|---|---|
--network <name> | Filter by network (default: all networks) |
--json | Output result as JSON |
Supported Networks
| Network | Description |
|---|---|
base | Base mainnet (primary) |
base-sepolia | Base testnet |
solana | Solana mainnet |
solana-devnet | Solana devnet |
Examples
# Check balance on all networks
npx agnic@latest balance --json
# Check balance on Base mainnet only
npx agnic@latest balance --network base --json
Expected Output
Network Balance Address
base 125.50 USDC 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
base-sepolia 0.00 USDC 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7
solana 0.00 USDC N/A
solana-devnet 0.00 USDC N/A
Error Handling
Common errors:
- "Not authenticated" -- Run
npx agnic@latest auth loginor setAGNIC_TOKEN - Network timeout -- Try again or specify a single network with
--network base