pay-for-service

Q: How do I install pay-for-service?

Run npx skills add https://github.com/coinbase/agentic-wallet-skills --skill pay-for-service in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/pay-for-service/ (personal) or .claude/skills/pay-for-service/ (project).

by coinbase OfficialBackend & APIs

Make a paid API request to an x402 endpoint with automatic USDC payment. Use when you or the user want to call a paid API, make an x402 request, use a paid service, or pay for an API call. Use after finding a service with search-for-service.

Installs: 2.9K
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/coinbase/agentic-wallet-skills --skill pay-for-service

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads pay-for-service automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Making Paid x402 Requests

Use the npx awal@2.10.0 x402 pay command to call paid API endpoints with automatic USDC payment on Base.

Confirm wallet is initialized and authed

npx awal@2.10.0 status

If the wallet is not authenticated, refer to the authenticate-wallet skill.

Command Syntax

npx awal@2.10.0 x402 pay <url> [-X <method>] [-d <json>] [-q <params>] [-h <json>] [--max-amount <n>] [--json]

Options

Option	Description
`-X, --method <method>`	HTTP method (default: GET)
`-d, --data <json>`	Request body as JSON string
`-q, --query <params>`	Query parameters as JSON string
`-h, --headers <json>`	Custom HTTP headers as JSON string
`--max-amount <amount>`	Max payment in USDC atomic units (1000000 = $1.00)
`--correlation-id <id>`	Group related operations
`--json`	Output as JSON

USDC Amounts

X402 uses USDC atomic units (6 decimals):

Atomic Units	USD
1000000	$1.00
100000	$0.10
50000	$0.05
10000	$0.01

IMPORTANT: Always single-quote amounts that use $ to prevent bash variable expansion (e.g. '$1.00' not $1.00).

Input Validation

Before constructing the command, validate all user-provided values to prevent shell injection:

url: Must be a valid URL starting with https:// or http://. Reject if it contains spaces, semicolons, pipes, backticks, or shell metacharacters.
data (-d): Must be valid JSON. Always wrap in single quotes to prevent shell expansion.
max-amount: Must be a positive integer (^\d+$).

Do not pass unvalidated user input into the command.

Examples

# Make a GET request (auto-pays)
npx awal@2.10.0 x402 pay https://example.com/api/weather

# Make a POST request with body
npx awal@2.10.0 x402 pay https://example.com/api/sentiment -X POST -d '{"text": "I love this product"}'

# Limit max payment to $0.10
npx awal@2.10.0 x402 pay https://example.com/api/data --max-amount 100000

Prerequisites

Must be authenticated (npx awal@2.10.0 status to check, see authenticate-wallet skill)
Wallet must have sufficient USDC balance (npx awal@2.10.0 balance to check)
If you don't know the endpoint URL, use the search-for-service skill to find services first

Error Handling

"Not authenticated" - Run awal auth login <email> first, or see authenticate-wallet skill
"No X402 payment requirements found" - URL may not be an x402 endpoint; use search-for-service to find valid endpoints
"Insufficient balance" - Fund wallet with USDC; see fund skill

FAQ

What does the pay-for-service skill do?

How do I install pay-for-service?

Run npx skills add https://github.com/coinbase/agentic-wallet-skills --skill pay-for-service in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/pay-for-service/ (personal) or .claude/skills/pay-for-service/ (project).

Which AI agents can use pay-for-service?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is pay-for-service safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains pay-for-service?

It is published by coinbase in coinbase/agentic-wallet-skills, and it is an official skill from the maker of the technology it covers. It has 2,946 recorded installs.