---
title: Check Balance
description: Check USDC balance across supported networks
---

# Check Balance

Check your USDC balance across all supported networks or filter to a specific one.

---

## Command

```bash
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

```bash
# 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; use `--token`, `AGNIC_TOKEN`, or browser login)

---

## Error Handling

| Error | Solution |
|-------|----------|
| "Not authenticated" | Provide `--token`, set `AGNIC_TOKEN`, or run `npx agnic@latest auth login` |
| Network timeout | Try again or specify a single network with `--network base` |

---

## Next Steps

<Cards>
  <Card title="Pay for Service" href="/docs/agentic-wallet/skills/pay-for-service">
    Make paid x402 API requests
  </Card>
  <Card title="Fund Wallet" href="/docs/agentic-wallet/skills/fund-wallet">
    Add funds to your wallet
  </Card>
</Cards>