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_TOKEN env var or pass --token <token>
• Interactive (has browser): Run npx agnic@latest auth login

See the authenticate-wallet skill for details.

Command Syntax#

bash

npx agnic@latest balance [--network <network>] [--json]

Options#

OptionDescription--network <name>Filter by network (default: all networks)--jsonOutput result as JSON

Supported Networks#

NetworkDescriptionbaseBase mainnet (primary)base-sepoliaBase testnetsolanaSolana mainnetsolana-devnetSolana devnet

Examples#

bash

# 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#

text

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 login or set AGNIC_TOKEN
• Network timeout -- Try again or specify a single network with --network base