---
title: Agentic Wallet
description: A self-sovereign wallet for AI agents — access APIs, fund wallets, and prove identity on Base
---

# Agentic Wallet

The next generation of AI agents won't just advise — they'll act. They'll access APIs autonomously and prove their identity. Agentic Wallet gives them the operational infrastructure to act independently, with built-in security guardrails.

---

## What is Agentic Wallet?

Agentic Wallet lets AI agents:

- **Access APIs** using the x402 protocol
- **Fund wallets** with USDC on Base
- **Prove identity** with ERC-8004 on-chain credentials

It ships as a set of **skills** (markdown instruction files) that teach any AI assistant how to use the `agnic` CLI. Install the skills, authenticate via browser OAuth or headless API token, and your agent is ready to transact.

---

## Agentic Wallet vs Direct SDK Integration

| Feature | Agentic Wallet | Direct SDK |
|---------|---------------|------------|
| **Setup time** | 1 command | Hours of integration |
| **Authentication** | Browser OAuth or headless token | API keys + manual rotation |
| **Spending limits** | Built-in per-session | Build it yourself |
| **x402 transactions** | Native support | Custom implementation |
| **Agent identity** | ERC-8004 on-chain | Not available |
| **AI assistant integration** | Skills system | Custom tool definitions |

---

## Use Cases

### The Machine Economy

Agents access compute, APIs, and data streams autonomously. x402 microtransactions make every resource accessible — no API keys, no subscriptions.

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

### Agentic Commerce

AI agents transacting with other AI agents for services. Monetize outputs and participate in creator economies. The internet of agents, powered by USDC.

### Identity-Verified Transactions

Unique to Agnic: ERC-8004 on-chain identity and KYA (Know Your Agent) verifiable credentials. Prove age, jurisdiction, and trust score to merchants that require it. No other wallet has this.

---

## Security & Guardrails

Autonomy doesn't mean unlimited access. Agentic Wallet includes programmable security controls:

| Guardrail | Description |
|-----------|-------------|
| **Session caps** | Maximum spend per CLI session, set during OAuth login |
| **Transaction limits** | Per-transaction size controls |
| **Self-custody** | Private keys in secure infrastructure, never exposed to agent prompts |
| **OAuth scoping** | Browser-based consent with explicit permission grants |
| **On-chain identity** | ERC-8004 agent NFT + trust score for verifiable interactions |
| **KYA credentials** | SD-JWT verifiable credentials for identity claims (age, jurisdiction) |

---

## How It Works

The architecture is designed for autonomous operation:

1. **Agent Skills** — Pre-built wallet operations (transact, fund, identity)
2. **`agnic` CLI** — Command-line bridge between your AI assistant and the wallet
3. **x402 Protocol** — Machine-to-machine authorization standard for API microtransactions
4. **USDC Wallet** — Self-custody wallet on Base with enforced spending limits
5. **Agnic Dashboard** — Usage monitoring, balance management at [app.agnic.ai](https://app.agnic.ai)

---

## Capabilities

| Capability | Description |
|-----------|-------------|
| **Self-custody wallet** | Non-custodial USDC wallet on Base. Your agent holds its own keys. |
| **Spending limits** | Per-session and daily caps set during OAuth login. |
| **Extensible skills** | 8 pre-built skills for AI assistants. Add custom skills via markdown. |
| **x402 transactions** | Access any x402-enabled API with a single command. |
| **ERC-8004 identity** | On-chain identity NFT, trust score, and KYA verifiable credentials. |

---

## Components

### `agnic` CLI

The command-line tool that powers all wallet operations:

```bash
npm install -g agnic

agnic auth login      # Authenticate via browser (or set AGNIC_TOKEN for headless)
agnic balance         # Check USDC balance
agnic x402 pay <url>       # Access an x402 API
```

### Agent Skills

Pre-built instruction files that teach AI assistants how to use the wallet:

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

8 skills included: authenticate, check-balance, search-for-service, pay-for-service, fund-wallet, get-agent-identity, agent-email, ai-gateway.

### x402 Protocol

HTTP 402-based microtransactions with USDC. Your agent sends a request, gets a 402 response with the price, signs an authorization, and retries — all handled automatically by the CLI.

---

## Next Steps

<Cards>
  <Card title="Quickstart" href="/docs/agentic-wallet/quickstart">
    Install, authenticate, and make your first transaction in under 2 minutes
  </Card>
  <Card title="Skills Reference" href="/docs/agentic-wallet/skills">
    Browse all pre-built agent skills
  </Card>
  <Card title="CLI Reference" href="/docs/agnicpay-features/cli">
    Full command reference for the agnic CLI
  </Card>
</Cards>
