agentic-wallet

by coinbase

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…

npx skills add https://github.com/coinbase/agentic-wallet-skills --skill agentic-wallet
Download ZIPGitHub
120

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.0 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:

TaskReference
Sign in, log in, connect wallet, OTP verification, "not signed in" errorsreferences/auth.md
Check balances, "how much USDC/ETH/POL/SOL do I have", balance per chain, JSON balance outputreferences/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 Polygonreferences/trade.md
Add funds, top up, onramp, buy USDCreferences/fund.md
Find / browse / search paid services on the x402 bazaarreferences/x402-search.md
Call a paid x402 API endpoint with automatic USDC paymentreferences/x402-pay.md
Build or deploy a paid API server that other agents can pay to usereferences/x402-monetize.md
Query onchain data on Base (events, transactions, blocks) via the CDP SQL APIreferences/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 awal command supports --json for machine-readable output.
  • Auth errors mean re-auth: if any command fails with "Not authenticated" or similar, read references/auth.md and run the sign-in flow.
  • Insufficient balance: read references/fund.md to top up.

Quick command index

CommandPurpose
npx awal@2.12.0 statusServer health + auth status
npx awal@2.12.0 addressGet wallet address
npx awal@2.12.0 balanceGet balances across Base, Polygon, Solana (use --chain for one chain)
npx awal@2.12.0 showOpen the wallet companion window (used for funding)
npx awal@2.12.0 auth login <email>Send OTP code
npx awal@2.12.0 auth verify <otp>Complete sign-in
npx awal@2.12.0 send <amount> <recipient>Send tokens
npx awal@2.12.0 trade <amount> <from> <to>Swap tokens
npx awal@2.12.0 x402 bazaar search <query>Search paid services
npx awal@2.12.0 x402 bazaar listList bazaar resources
npx awal@2.12.0 x402 details <url>Inspect payment requirements
npx awal@2.12.0 x402 pay <url>Pay and call an x402 endpoint

More skills from coinbase

git.repo-manager
coinbase
git.repo-manager — an installable skill for AI agents, published by coinbase/cds.
official
cds-accessibility
coinbase
Reviews already-written Coinbase Design System (CDS) UI for accessibility: verifying documented accessibility props (e.g. accessibilityLabel,…
official
cds-migrator-transform
coinbase
Use when a CDS change in **cds-web**, **cds-common**, **cds-mobile**, **web-visualization**, or **mobile-visualization** needs a **jscodeshift** migration in…
official
query-blockchain-data
coinbase
Query onchain blockchain data on Base using the CDP SQL API via x402. Use when you or your user want to view onchain information about decoded blocks,…
official
authenticate-wallet
coinbase
Email OTP-based wallet authentication with validation and status checking. Two-step login flow: initiate with email to receive a 6-digit OTP, then verify with the flowId and code to complete authentication Includes input validation rules for email, flowId, and OTP to prevent shell injection before executing commands Provides status checking, balance queries, address retrieval, and wallet window access via companion CLI commands All commands support --json output for machine-readable...
official
fund
coinbase
Deposit USDC to wallet via Coinbase Onramp or direct transfer. Opens a companion UI where users select preset amounts ($10, $20, $50) or custom values and choose from Apple Pay, debit card, bank transfer, or Coinbase account funding Supports multiple payment methods with varying settlement times: instant for card and Apple Pay, 1–3 days for ACH bank transfers Deposits funds as USDC on the Base network; alternatively, users can send USDC directly to the wallet address via npx awal@2.0.3...
official
monetize-service
coinbase
Deploy a paid API endpoint that other agents can discover and pay for via x402 protocol. Charges USDC per request on Base using HTTP 402 payment protocol; clients pay with signed transactions, no API keys or accounts required Automatically registers endpoints with the x402 Bazaar for agent discovery when you declare discovery extensions Supports multiple pricing tiers, wildcard routes, and multiple payment options per endpoint using Express middleware Built on @x402/express and @x402/core...
official
pay-for-service
coinbase
Call paid APIs on Base with automatic USDC payment via x402 protocol. Executes HTTP requests (GET, POST, etc.) to x402-enabled endpoints with atomic USDC payments handled automatically Supports request customization through method, JSON body, query parameters, and custom headers Includes payment controls: set maximum USDC amount per request and group related operations with correlation IDs Requires wallet authentication and sufficient USDC balance; validates all user input to prevent shell...
official