balance
Query gas and token balances on Base, Polygon, and Solana.
Developer Setup
Setup & Installation
npx skills add https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/references/balance.md --skill balancenpx skills add https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/references/balance.md --skill balanceOverview
What This Skill Does
Queries token balances (including USDC and native gas tokens) across multiple chains (Base, Polygon, Solana) in a single CLI command.
Application
When to use this Skill
- Retrieving token balances for USDC and gas tokens across onchain networks.
- Querying specific gas or token balances on Base, Polygon, or Solana.
- Formatting balance results to JSON for machine-readable consumption.
- Auditing wallet funds before initiating token transfers.
- Checking wallet addresses loaded in active terminal sessions.
Documentation
Show Skills.md file
Checking Wallet Balances
Use the npx awal@2.10.0 balance command to fetch token balances across chains. By default it returns balances for USDC + the native gas token on Base, Polygon, and Solana in a single call.
If the wallet is not authenticated, see references/auth.md. The CLI reads the address from the local wallet session — you do not pass an address argument.
Command Syntax
npx awal@2.10.0 balance [--chain <chain>] [--asset <asset>] [--json]
Options
| Option | Description |
|---|---|
--chain <chain> |
Restrict output to one chain. One of base, base-sepolia, polygon, solana, solana-devnet. Default: all chains. |
--asset <asset> |
Show only one asset across the queried chain(s). One of usdc, eth, pol, sol. |
--json |
Emit machine-readable JSON instead of the human table. |
-h, --help |
Print built-in help. |
If both --chain and --asset are omitted, the command queries every supported mainnet chain (Base, Polygon, Solana) and every native asset on each.
Note on
--asset: Although the CLI's invalid-asset error message implies a0xcontract address is accepted, passing one currently fails checksum validation (the CLI uppercases the address). In practice, only the symbolic valuesusdc,eth,pol,solwork. Stick to those.
Recommendations
Explore other random skills
autobrowse
Self-improving browser automation via the auto-research loop. Iteratively runs a browsing task, reads the trace, and improves the navigation skill (strategy.md) until it reliably passes. Supports parallel runs across multiple tasks using sub-agents. Use when you want to build or improve browser automation skills for specific website tasks.
browser-to-api
Turn a website's observable HTTP traffic into a best-effort OpenAPI 3.1 spec by analyzing a `browser-trace` capture. Use when the user wants to discover/extract API endpoints from a browser session, build an OpenAPI doc from network traffic, or document a third-party site's XHR/fetch surface for client integration.
browser-trace
Capture a full DevTools-protocol trace of any browser automation — CDP firehose, screenshots, and DOM dumps — then bisect the stream into per-page searchable buckets. Use when the user wants to debug a failed run, audit network/console/DOM activity, attach a trace to an in-progress session, or feed structured per-page summaries back into an agent loop so its next iteration learns from the last one.