How to Set Up an AI Agent Wallet on Base: A Step-by-Step Guide

Your AI agent can reason, plan, and execute tasks. But without a wallet, it cannot pay for anything. Here is how to give your agent a wallet in under 10 minutes.

An agent wallet is a crypto wallet created for and controlled by an AI agent. It lets the agent hold, send, and receive cryptocurrency without human approval for every transaction. Think of it as the difference between an assistant who has to ask you for your credit card every time they buy something, and one who has a company card with clear spending limits.

In 2026, this distinction matters because agents are starting to pay for APIs, move funds, and participate in onchain workflows without a human approving every step. Without a wallet, an agent is just a chatbot with opinions.

Why Your Agent Needs a Wallet

Three forces are making agent wallets essential:

Agent-to-agent commerce is real. ERC-8183 is a draft standard for escrowed agent commerce, where a client funds a job, a provider submits work, and an evaluator attests completion. But none of that works if your agent cannot hold and transfer funds.

APIs now charge per call. The x402 protocol lets any API endpoint charge micro-payments in USDC. Your agent needs a funded wallet to consume these services.

Reputation follows the wallet. Under ERC-8004, an agent registers on-chain identity through standardized registries for identity, reputation, and validation. The wallet address anchors that identity across platforms. The wallet is not just a payment tool, it is the agent's identity anchor.

Before You Start

This guide focuses on Coinbase Agentic Wallets on Base L2, which is the fastest path to a working agent wallet today. If you need multi-chain support or more control, see the AgentKit option below. You will need a Coinbase developer account and Node.js installed.

Option 1: Coinbase Agentic Wallets

Coinbase launched Agentic Wallets in February 2026 as wallet infrastructure designed for autonomous AI agents. It runs on Base L2, supports gasless transactions, and includes programmable spending limits.

Here is what you get out of the box:

• Self-custody wallet controlled by the agent
• Spending caps per session and per transaction
• Gasless token swaps on Base
• Built-in OFAC compliance screening
• x402 payment support for machine-to-machine APIs

Step 1: Install the awal CLI

The awal CLI is the command-line interface for Agentic Wallet operations. Install it with npm:

npx awal status

This checks your authentication status. On first run, it will walk you through the setup flow.

Step 2: Authenticate Your Agent

Authentication happens via email OTP. Your agent's private keys never leave Coinbase infrastructure, which means you do not need to manage seed phrases or worry about key exposure.

npx awal auth

Follow the prompts to link your Coinbase developer account. Key management is handled by Coinbase infrastructure, so you do not deal with seed phrases directly. Transactions are authorized through the API layer tied to your agent's authenticated session.

Step 3: Fund the Wallet

Before your agent can transact, it needs USDC. You can fund from a linked Coinbase account or transfer from another wallet:

npx awal fund 10

This deposits 10 USDC into the agent's wallet. For testing, Base's sub-cent gas fees mean even a small amount goes a long way.

Step 4: Install Agent Skills

Agent Skills are pre-built financial operations that your agent can invoke. Instead of writing transaction logic from scratch, you install skills and let the agent handle the rest:

npx skills add coinbase/agentic-wallet-skills

Available skills include:

Skill	What It Does
authenticate	Handle wallet login flows
fund	Deposit USDC into the wallet
send	Transfer USDC to an address or ENS name
trade	Swap tokens on Base
search-for-service	Find x402-enabled API services
pay-for-service	Make paid API calls via x402
monetize-service	Build a paid API that other agents can consume

Step 5: Set Spending Guardrails

This is where Agentic Wallets differ from regular crypto wallets. Before your agent starts transacting, configure spending limits:

• Per-transaction cap: Maximum amount the agent can spend in a single transaction
• Per-session cap: Total spending limit within a session window
• KYT screening: Automatic blocking of high-risk addresses
• OFAC compliance: All transfers screened against sanctions lists

These guardrails are enforced before any transaction reaches the chain. Your agent cannot exceed its configured limits because the infrastructure rejects transactions that breach them.

Step 6: Test with a Simple Transaction

npx awal send 1 vitalik.eth

If this completes successfully, your agent wallet is fully operational. Your agent can now pay for APIs, send tips, trade tokens, and participate in the agent economy.

Option 2: Coinbase AgentKit

If you need more control than the Agentic Wallet CLI provides, AgentKit is the full SDK for onchain agent operations. It supports deploying contracts, interacting with any EVM chain, and Solana.

Key differences:

Feature	Agentic Wallet	AgentKit
Integration	CLI or MCP tools	Import into agent code
Scope	Wallet operations	Full onchain capabilities
Networks	Base only	Multi-network (EVM + Solana)
Complexity	Low	Medium

AgentKit is the better choice if your agent needs to deploy smart contracts, interact with DeFi protocols on multiple chains, or run complex multi-step transaction flows.

Security Architecture

Agent wallets introduce a new security model. Your agent is autonomous, which means the security guardrails matter more than they do for human-controlled wallets.

Key isolation. Private keys never touch your agent's runtime. Coinbase infrastructure manages key storage and transaction signing. Your agent authorizes transactions through the API, but never sees the raw keys.

Programmable limits. Unlike a human wallet where you might override your own budget, agent spending limits are hard-coded at the infrastructure level. There is no "are you sure?" prompt. The agent hits the limit and the transaction is rejected.

Compliance screening. Every outbound transfer is checked against OFAC sanctions lists and risk scores. This is critical for agents operating in regulated environments or handling payments from unknown counterparties.

Session scoping. Spending limits reset per session, which prevents a compromised agent from accumulating damage over time.

Connecting Your Wallet to AgentLux

Once your agent has a wallet, you can register its on-chain identity through ERC-8004 on AgentLux. The wallet address becomes the anchor for your agent's identity, reputation, and transaction history. For a deep dive on identity registration, see our guide to registering an ERC-8004 identity.

The flow is straightforward:

1. Set up the agent wallet using the steps above
2. Register an ERC-8004 identity on AgentLux using the wallet address
3. Begin building reputation through completed transactions and verified interactions
4. The wallet, identity, and reputation form a portable trust signal that follows your agent across platforms

For agents planning to transact with other agents, our KYA guide covers the trust and verification layer that sits on top of wallet identity.

Common Pitfalls

Skipping the guardrails. Do not set up a wallet without configuring spending limits first. An agent without guardrails is a liability, not an asset.

Under-funding for testing. Base gas fees are sub-cent, but your agent still needs enough USDC to complete transactions. Start with at least 5 USDC for testing.

Ignoring the skill library. Building custom transaction logic when pre-built skills exist is wasted effort. Install the wallet skills first, then build custom capabilities only if the defaults do not cover your use case.

Forgetting identity registration. A wallet without an ERC-8004 identity is anonymous. Register your agent's identity to unlock reputation scoring and cross-platform trust.

The Bottom Line

An AI agent without a wallet is like a business without a bank account. It can talk about doing things, but it cannot actually transact. Coinbase Agentic Wallets on Base offer one practical path: install the CLI, authenticate, fund, set guardrails, and go. If you need multi-chain support or deeper smart contract interactions, AgentKit or a custom wallet provider may fit better.

The agent economy is not a future concept. It is happening now, on Base, with real payments flowing between autonomous agents. The question is not whether your agent needs a wallet, but how quickly you can get one set up.

Start with npx awal status and have your agent transacting today. For the full picture of how wallets fit into the agent economy, read our guide to agentic commerce in 2026.