---
title: Quickstart
description: Install Agentic Wallet skills, authenticate, and make your first transaction in 5 minutes
---

# Quickstart

Get your AI agent transacting in 5 minutes. This guide covers installation, authentication, and your first wallet operations.

---

## Prerequisites

- **Node.js 18+** installed
- An AI assistant that supports skills (e.g., Claude Code, Cline, Cursor, Windsurf)

---

## 1. Install the Skills

Add the Agentic Wallet skills to your AI assistant:

```bash
npx skills add agnicpay/agnic-wallet-skills
```

This installs 8 skills that teach your agent how to use the `agnic` CLI for wallet operations.

---

## 2. Authenticate

### Option A: Headless (CI, servers, AI agents)

Generate an API token at [app.agnic.ai](https://app.agnic.ai) > Settings > API Tokens:

```bash
export AGNIC_TOKEN=<your-api-token>
npx agnic@latest status --json
```

All commands in the session authenticate automatically. No browser required.

### Option B: Browser OAuth (interactive terminals)

```bash
npx agnic@latest auth login
```

This command:
1. Opens your default browser to Agnic's OAuth consent screen
2. You sign in (email, Google, or wallet) and approve spending limits
3. The browser redirects back and the CLI saves tokens locally

Wait for `Authenticated!` before proceeding.

### Verify Authentication

```bash
npx agnic@latest status --json
```

Expected output:

```json
{
  "authenticated": true,
  "userId": "did:privy:...",
  "email": "you@example.com",
  "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7",
  "tokenExpiry": "2026-05-22T14:30:00Z"
}
```

---

## 3. Check Your Balance

```bash
npx agnic@latest balance
```

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

If your balance is zero, see the [Fund Wallet](/docs/agentic-wallet/skills/fund-wallet) skill for funding instructions.

---

## 4. Access an x402 API

<Callout type="info">
  One-time step: enable X402 Payments under **Settings → Credits** in the [dashboard](https://app.agnic.ai) before your first x402 call. Availability varies by region.
</Callout>

Search the bazaar for a service:

```bash
npx agnic@latest x402 bazaar search "weather"
```

Make a request:

```bash
npx agnic@latest x402 pay https://api.example.com/weather --json
```

The CLI auto-detects the price, signs a USDC authorization, and returns the API response.

---

## 5. Check Agent Identity

View your agent's on-chain ERC-8004 identity:

```bash
npx agnic@latest agent-identity --json
```

```json
{
  "agentId": 373,
  "ownerAddress": "0x046906b3cd9d73bf85eb01d795d333b364b75842",
  "status": "active",
  "trustScore": 85,
  "categories": ["payment", "general"],
  "hasDelegation": true
}
```

---

## Next Steps

<Cards>
  <Card title="Skills Reference" href="/docs/agentic-wallet/skills">
    Browse all pre-built agent skills
  </Card>
  <Card title="x402 Transactions" href="/docs/x402/x402-fetch">
    Learn about the x402 transaction proxy
  </Card>
  <Card title="Agent Identity" href="/docs/agentic-wallet/skills/get-agent-identity">
    ERC-8004 identity and trust scores
  </Card>
</Cards>