Quickstart

Get your first agentic wallet running in under 2 minutes.

Prerequisites

Node.js 24+
An email address for wallet authentication
Install our package built on top of Vercel AI SDK skills:

npx skills add coinbase/agentic-wallet-skills

CLI commands

The awal CLI provides all the tools you need to manage agentic wallets:

Command	Purpose
`npx awal status`	Check 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 address`	Get wallet address
`npx awal show`	Open 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 quit`	Stop the background wallet server
`npx awal telemetry enable`	Opt into anonymous usage telemetry
`npx awal telemetry disable`	Opt out of telemetry
`npx awal persistence enable`	Keep session active between runs
`npx awal persistence disable`	Disable 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: 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

GET STARTED

WALLETS

PAYMENTS

STABLECOINS

TRADING

ONCHAIN TOOLS

CUSTOMERS

WEBHOOKS

CONSUMER APIS

BUSINESS APIS

INSTITUTIONAL APIS

Prerequisites

CLI commands

Authenticating an agentic wallet

2. Verify OTP

3. Confirm authentication

Example usage

JSON output

What to read next

Skills Reference

x402 Protocol

​Prerequisites

​CLI commands

​Authenticating an agentic wallet

​1. Initiate login

​2. Verify OTP

​3. Confirm authentication

​Example usage

​JSON output

​What to read next

Skills Reference

x402 Protocol

Prerequisites

CLI commands

Authenticating an agentic wallet

1. Initiate login

2. Verify OTP

3. Confirm authentication

Example usage

JSON output

What to read next