Skip to main content
Get your first agentic wallet running in under 2 minutes.

​
Prerequisites

npx skills add coinbase/agentic-wallet-skills

​
CLI commands

The awal CLI provides all the tools you need to manage agentic wallets:
CommandPurpose
npx awal statusCheck server health and auth status
npx awal auth login <email>Send OTP code to email, returns flowId
npx awal auth verify <flowId> <otp>Complete authentication with OTP code
npx awal balance [--chain]Get USDC wallet balance
npx awal addressGet wallet address
npx awal showOpen the wallet companion window
npx awal send <amount> <recipient> [--chain]Send USDC to an address or ENS name
npx awal trade <amount> <from> <to>Trade tokens on Base
npx awal x402 bazaar search <query>Search for paid API services
npx awal x402 pay <url>Make a paid API request
npx awal quitStop the background wallet server
npx awal telemetry enableOpt into anonymous usage telemetry
npx awal telemetry disableOpt out of telemetry
npx awal persistence enableKeep session active between runs
npx awal persistence disableDisable session persistence
The balance and send commands accept --chain with: base (default), base-sepolia (testnet), solana, solana-devnet, or polygon. Trading is only available on Base mainnet.

​
Authenticating an agentic wallet

Authentication uses an initiate, then verify process:

​
1. Initiate login

The following will install the awal package and create an agentic wallet mapped to the given email: 
npx awal auth login user@example.com
You should see similar output: 
✓ Verification code sent!
ℹ Check your email (user@example.com) for a 6-digit code.

Flow ID: 8beba1c2-5674-4f24-a0fa-...

To complete sign-in, run:
  awal auth verify 8beba1c2-5674-4f24-a0fa-... <6-digit-code>

​
2. Verify OTP

To complete agentic wallet authentication, provide the flowId from the previous step and the 6-digit verification code: 
npx awal auth verify <flowId> <otp>
You should see similar output: 
✔ Authentication successful!
Successfully signed in as user@example.com

You can now use wallet commands:
  awal balance
  awal address

​
3. Confirm authentication

npx awal status
You should see similar output: 
Wallet Server
✓ Running (PID: 61234)

Authentication
✓ Authenticated
Logged in as: user@example.com

​
Example usage

# Check current status
npx awal status

# Start login (sends OTP to email)
npx awal auth login agent@mycompany.com
# Output: flowId: abc123...

# After receiving code, verify
npx awal auth verify abc123 123456

# Confirm authentication
npx awal status

# Check balance
npx awal balance

# Check Solana balance
npx awal balance --chain solana

# Send USDC on Base
npx awal send 1 vitalik.eth

# Send USDC on Solana
npx awal send 1 <solana-address> --chain solana

# Send USDC on Polygon
npx awal send 1 0x1234...abcd --chain polygon

# Trade tokens
npx awal trade 5 usdc eth

​
JSON output

All commands support --json for machine-readable output: 
npx awal status --json
npx awal auth login user@example.com --json
npx awal balance --json

Skills Reference

Explore all available agent skills

x402 Protocol

Learn about machine-to-machine payments