agnicpay

check-balance

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".

agnicpay 0 Updated 3mo ago
GitHub

Install

npx skillscat add agnicpay/agnic-wallet-skills/check-balance

Install via the SkillsCat registry.

SKILL.md

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