agentic-wallet
coinbase/agentic-wallet-skills
Crypto wallet operations and x402 payment protocol integration via CLI.
What is agentic-wallet?
Operate a crypto wallet through the awal CLI to sign in, check balances, send USDC/ETH/POL/SOL, trade tokens, fund the wallet, and use the x402 payment protocol to discover and pay for services or monetize APIs. Use this skill whenever the user mentions wallet authentication, balance checks, token transfers, swaps, funding, or x402 bazaar interactions.
- Sign in and authenticate wallet via OTP verification
- Check balances across Base, Polygon, and Solana chains
- Send USDC, ETH, POL, or SOL to addresses or ENS names
- Swap and trade tokens on Base or Polygon
- Fund and top up wallet via onramp
- Search and discover paid services on the x402 bazaar
How to install agentic-wallet
npx skills add https://github.com/coinbase/agentic-wallet-skills --skill agentic-wallet- Node.js and npm installed
- awal CLI (installed via npx awal@2.12.1)
- Coinbase wallet account for authentication
How to use agentic-wallet
- 1.Check wallet authentication status with `npx awal@2.12.1 status`
- 2.If not authenticated, read references/auth.md and sign in with `npx awal@2.12.1 auth login <email>`
- 3.Verify OTP with `npx awal@2.12.1 auth verify <otp>`
- 4.For balance checks, run `npx awal@2.12.1 balance` or `npx awal@2.12.1 balance --chain <chain>`
- 5.For sending tokens, use `npx awal@2.12.1 send <amount> <recipient>` with validated inputs
- 6.For swaps, use `npx awal@2.12.1 trade <amount> <from> <to>`
- 7.For x402 operations, search with `npx awal@2.12.1 x402 bazaar search <query>` and pay with `npx awal@2.12.1 x402 pay <url>`
- 8.Always validate user input against regex allowlists before passing to shell commands
Use cases
- Authenticate a wallet and check balances before performing transactions
- Send cryptocurrency to another user or address
- Swap tokens to convert between different cryptocurrencies
- Top up a wallet with fiat or stablecoin funding
- Discover and pay for third-party APIs through the x402 bazaar
- Developers building crypto-enabled agents
- Users managing multi-chain wallets (Base, Polygon, Solana)
- API builders looking to monetize endpoints via x402 protocol
- Agents needing to pay for external services programmatically
agentic-wallet FAQ
Base, Polygon, and Solana. The wallet can check balances and perform operations across all three chains.
USDC, ETH, POL, and SOL. Use the send command with the token amount and recipient address or ENS name.
Use `npx awal@2.12.1 show` to open the wallet companion window, or read references/fund.md for onramp and top-up options.
x402 is a payment protocol for discovering and paying for services. Use `awal x402 bazaar search` to find paid APIs and `awal x402 pay` to call them with automatic USDC payment.
Read references/auth.md and run the sign-in flow again with `npx awal@2.12.1 auth login <email>` followed by OTP verification.
Full instructions (SKILL.md)
Source of truth, from coinbase/agentic-wallet-skills.
name: agentic-wallet description: "Crypto wallet operations via the awal CLI — sign in, check balances, send USDC/ETH/POL/SOL, trade tokens, fund the wallet, and use the x402 payment protocol to discover paid services, pay for API calls, monetize an API, or query onchain data. Use whenever the user mentions signing in, login, authentication, wallet status, balance, address, sending money, paying someone, transferring tokens, ENS names, swapping/trading/converting tokens, funding/topping up/onramp, USDC, ETH, POL, SOL, the x402 bazaar, paid APIs, monetizing an endpoint, or querying onchain data on Base." user-invocable: true disable-model-invocation: false allowed-tools: ["Bash(npx awal@2.12.1 *)", "Bash(npm *)", "Bash(node *)", "Bash(curl *)", "Bash(mkdir *)"]
Agentic Wallet
Operate a crypto wallet through the awal CLI. This skill is a router: read the relevant reference file in references/ for the task at hand.
Preflight: Confirm wallet state
Before any wallet operation that requires authentication (everything except x402 search/details), check status:
npx awal@2.12.1 status
If the wallet is not authenticated, read references/auth.md and complete sign-in first.
Routing
Pick the reference that matches the task and Read it before acting:
| Task | Reference |
|---|---|
| Sign in, log in, connect wallet, OTP verification, "not signed in" errors | references/auth.md |
| Check balances, "how much USDC/ETH/POL/SOL do I have", balance per chain, JSON balance output | references/balance.md |
| Send USDC / ETH / POL / SOL to an address or ENS name (Base, Polygon, Solana) | references/send-usdc.md |
| Swap / trade / convert tokens on Base or Polygon | references/trade.md |
| Add funds, top up, onramp, buy USDC | references/fund.md |
| Find / browse / search paid services on the x402 bazaar | references/x402-search.md |
| Call a paid x402 API endpoint with automatic USDC payment | references/x402-pay.md |
| Build or deploy a paid API server that other agents can pay to use | references/x402-monetize.md |
| Query onchain data on Base (events, transactions, blocks) via the CDP SQL API | references/query-onchain.md |
If no clear match and the user wants an external capability, search the x402 bazaar (references/x402-search.md) — a paid service may exist.
Shared rules
- Input validation: every reference lists the regexes / allowlists that user-provided values must match before being placed in a shell command. Validate strictly; reject inputs containing spaces, semicolons, pipes, backticks, or other shell metacharacters. Do not pass unvalidated user input into commands.
- Single-quote
$amounts: any amount written as'$1.00'must be single-quoted to prevent bash variable expansion. - JSON output: every
awalcommand supports--jsonfor machine-readable output. - Auth errors mean re-auth: if any command fails with "Not authenticated" or similar, read
references/auth.mdand run the sign-in flow. - Insufficient balance: read
references/fund.mdto top up.
Quick command index
| Command | Purpose |
|---|---|
npx awal@2.12.1 status | Server health + auth status |
npx awal@2.12.1 address | Get wallet address |
npx awal@2.12.1 balance | Get balances across Base, Polygon, Solana (use --chain for one chain) |
npx awal@2.12.1 show | Open the wallet companion window (used for funding) |
npx awal@2.12.1 auth login <email> | Send OTP code |
npx awal@2.12.1 auth verify <otp> | Complete sign-in |
npx awal@2.12.1 auth logout | Sign out and clear the session |
npx awal@2.12.1 send <amount> <recipient> | Send tokens |
npx awal@2.12.1 trade <amount> <from> <to> | Swap tokens |
npx awal@2.12.1 x402 bazaar search <query> | Search paid services |
npx awal@2.12.1 x402 bazaar list | List bazaar resources |
npx awal@2.12.1 x402 details <url> | Inspect payment requirements |
npx awal@2.12.1 x402 pay <url> | Pay and call an x402 endpoint |
Related skills
More from coinbase/agentic-wallet-skills and the wider catalog.
authenticate-wallet
Sign in to your wallet via email OTP before sending, trading, or funding.
fund
Add money to your wallet via Coinbase Onramp with multiple payment methods.
monetize-service
Build and deploy a paid API that other agents can pay to use via x402 payment protocol.
pay-for-service
Call paid APIs with automatic USDC payment on Base via x402 protocol.
query-onchain-data
Query onchain data on Base using the CDP SQL API via x402 with decoded events, transactions, and blocks.
search-for-service
Search and browse the x402 bazaar marketplace for paid API services.