> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cdp.coinbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

Get your first agentic wallet running in under 2 minutes.

## Prerequisites

* [Node.js 24+](https://nodejs.org/en/download)
* An email address for wallet authentication
* Install our package built on top of [Vercel AI SDK skills](https://sdk.vercel.ai/docs):

```bash theme={null}
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            |

<Note>
  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.
</Note>

## 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:

```bash theme={null}
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:

```bash theme={null}
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

```bash theme={null}
npx awal status
```

You should see similar output:

```
Wallet Server
✓ Running (PID: 61234)

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

## Example usage

```bash theme={null}
# 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:

```bash theme={null}
npx awal status --json
npx awal auth login user@example.com --json
npx awal balance --json
```

## What to read next

<CardGroup cols={2}>
  <Card title="Skills Reference" icon="puzzle-piece" href="/agentic-wallet/cli/skills/overview">
    Explore all available agent skills
  </Card>

  <Card title="x402 Protocol" icon="bolt" href="/x402/core-concepts/how-it-works">
    Learn about machine-to-machine payments
  </Card>
</CardGroup>