--- title: "coinbase/agentic-wallet-skills" description: "npx skills add coinbase/agentic-wallet-skills" source: https://github.com/coinbase/agentic-wallet-skills ref: main license: MIT licenseName: "MIT License" canonical: https://skillsdocs.com/coinbase/agentic-wallet-skills base: https://github.com/coinbase/agentic-wallet-skills/blob/main/ chapters: 1 inlined: 1 withheld: 0 words: 350 updated: 2026-08-04T18:48:24Z generator: "Skills Docs" --- > **coinbase/agentic-wallet-skills** — every Agent Skill in this repository, inlined verbatim. > > Canonical HTML: https://skillsdocs.com/coinbase/agentic-wallet-skills > Per-chapter Markdown: https://skillsdocs.com/coinbase/agentic-wallet-skills/.md > Machine manifest: https://skillsdocs.com/coinbase/agentic-wallet-skills/.well-known/agent-skills/index.json > JSON: https://skillsdocs.com/api/v1/books/coinbase/agentic-wallet-skills > Install: `npx skills add coinbase/agentic-wallet-skills` > Upstream: https://github.com/coinbase/agentic-wallet-skills @ `main` > Licence: MIT > > Content is mirrored from GitHub and © its authors, served unmodified. Takedown: https://github.com/DreambaseAI/skillsdocs/issues/new?labels=takedown&title=Takedown+request # coinbase/agentic-wallet-skills npx skills add coinbase/agentic-wallet-skills - **Chapters:** 1 - **Inlined:** 1 (licence detected) - **Words:** 350 - **Reading time:** 2 min - **Stars:** 125 ## Table of contents 1. [agentic-wallet](https://skillsdocs.com/coinbase/agentic-wallet-skills/agentic-wallet.md) — 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… ## Front matter _The repository README, verbatim except that relative links are resolved against https://github.com/coinbase/agentic-wallet-skills/blob/main/._ # Coinbase Agentic Wallet Skills [Agent Skills](https://agentskills.io) for crypto wallet operations. These skills enable AI agents to authenticate, send USDC, trade tokens and more using the [`awal`](https://www.npmjs.com/package/awal) CLI. ## What it does A single skill — [`agentic-wallet`](https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/SKILL.md) — that routes the agent to topic-specific reference docs in [`./skills/agentic-wallet/references/`](https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/references/): | Capability | Reference | | --- | --- | | Sign in via email OTP | [`auth.md`](https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/references/auth.md) | | Check wallet balances across Base, Polygon, and Solana | [`balance.md`](https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/references/balance.md) | | Send USDC / ETH / POL / SOL on Base, Polygon, or Solana | [`send-usdc.md`](https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/references/send-usdc.md) | | Swap / trade tokens on Base or Polygon | [`trade.md`](https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/references/trade.md) | | Add funds via Coinbase Onramp | [`fund.md`](https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/references/fund.md) | | Search the x402 bazaar for paid API services | [`x402-search.md`](https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/references/x402-search.md) | | Pay an x402 endpoint with automatic USDC payment | [`x402-pay.md`](https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/references/x402-pay.md) | | Build and deploy a paid API server (x402) | [`x402-monetize.md`](https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/references/x402-monetize.md) | | Query onchain data on Base via the CDP SQL API | [`query-onchain.md`](https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/references/query-onchain.md) | ## Installation Install with [Vercel's Skills CLI](https:/skills.sh): ```bash npx skills add coinbase/agentic-wallet-skills ``` ## Usage Skills are automatically available once installed. The agent will use them when relevant tasks are detected. **Examples:** ```text Sign-in to my wallet with me@email.com ``` ```text Send 10 USDC to barmstrong.eth ``` ## Contributing To add a new capability: 1. Create a new markdown file in `./skills/agentic-wallet/references/` 2. Add a row to the routing table in `./skills/agentic-wallet/SKILL.md` describing when the agent should read it 3. If the capability needs a new shell tool, add it to `allowed-tools` in `SKILL.md` frontmatter See the [Agent Skills specification](https://agentskills.io/specification) for the complete format. ### Updating the `awal` version The `awal` CLI version is pinned in every code block in `SKILL.md` and the reference docs. When a new version is published to npm, run: ```bash # Make sure you're using Node v22+ node ./scripts/bump-awal.js ``` This fetches the latest version from the npm registry and rewrites every `awal@` reference under `./skills/`. ## License MIT --- ## 1. agentic-wallet - **Source:** https://github.com/coinbase/agentic-wallet-skills/blob/main/skills/agentic-wallet/SKILL.md - **Raw:** https://raw.githubusercontent.com/coinbase/agentic-wallet-skills/main/skills/agentic-wallet/SKILL.md - **Markdown:** https://skillsdocs.com/coinbase/agentic-wallet-skills/agentic-wallet.md - **Licence:** MIT — https://spdx.org/licenses/MIT.html Bundled files (9), referenced from this skill's directory: - `references/auth.md` — https://raw.githubusercontent.com/coinbase/agentic-wallet-skills/main/skills/agentic-wallet/references/auth.md - `references/balance.md` — https://raw.githubusercontent.com/coinbase/agentic-wallet-skills/main/skills/agentic-wallet/references/balance.md - `references/fund.md` — https://raw.githubusercontent.com/coinbase/agentic-wallet-skills/main/skills/agentic-wallet/references/fund.md - `references/query-onchain.md` — https://raw.githubusercontent.com/coinbase/agentic-wallet-skills/main/skills/agentic-wallet/references/query-onchain.md - `references/send-usdc.md` — https://raw.githubusercontent.com/coinbase/agentic-wallet-skills/main/skills/agentic-wallet/references/send-usdc.md - `references/trade.md` — https://raw.githubusercontent.com/coinbase/agentic-wallet-skills/main/skills/agentic-wallet/references/trade.md - `references/x402-monetize.md` — https://raw.githubusercontent.com/coinbase/agentic-wallet-skills/main/skills/agentic-wallet/references/x402-monetize.md - `references/x402-pay.md` — https://raw.githubusercontent.com/coinbase/agentic-wallet-skills/main/skills/agentic-wallet/references/x402-pay.md - `references/x402-search.md` — https://raw.githubusercontent.com/coinbase/agentic-wallet-skills/main/skills/agentic-wallet/references/x402-search.md --- 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: ```bash 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 `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 | 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 ` | Send OTP code | | `npx awal@2.12.1 auth verify ` | Complete sign-in | | `npx awal@2.12.1 auth logout` | Sign out and clear the session | | `npx awal@2.12.1 send ` | Send tokens | | `npx awal@2.12.1 trade ` | Swap tokens | | `npx awal@2.12.1 x402 bazaar search ` | Search paid services | | `npx awal@2.12.1 x402 bazaar list` | List bazaar resources | | `npx awal@2.12.1 x402 details ` | Inspect payment requirements | | `npx awal@2.12.1 x402 pay ` | Pay and call an x402 endpoint |