check-balance

name	check-balance
description	Check USDC balance across networks. Use when you or the user want to check balance, see how much money is in the wallet, view funds, or check available USDC. Covers phrases like "check my balance", "how much USDC do I have", "what's my balance", "show funds", "wallet balance".
user-invocable	true
disable-model-invocation	false
allowed-tools	["Bash(npx agnic@latest status*)","Bash(npx agnic@latest balance*)"]

Checking USDC Balance

Use the npx agnic@latest balance command to check USDC balance across supported networks.

Confirm wallet is initialized and authed

npx agnic@latest status

If the wallet is not authenticated, refer to the authenticate-wallet skill.

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

# Check balance on Base mainnet only
npx agnic@latest balance --network base

# Get JSON output
npx agnic@latest balance --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

Prerequisites

• Must be authenticated (npx agnic@latest status to check)

Error Handling

Common errors:

• "Not authenticated" — Run npx agnic@latest auth login first
• Network timeout — Try again or specify a single network with --network base