Coinbase Pay-for-Service：使用 USDC 自动支付 API 调用费用的完整指南

pay-for-service by coinbase/agentic-wallet-skills

1,600 周安装量

86 GitHub Stars

GitHub

安装命令

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

开发区块链

🇨🇳中文介绍

发起付费 x402 请求

使用 npx awal@2.0.3 x402 pay 命令，通过 Base 网络自动支付 USDC 来调用付费 API 端点。

确认钱包已初始化并授权

npx awal@2.0.3 status

如果钱包未授权，请参考 authenticate-wallet 技能。

命令语法

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

选项

选项	描述
`-X, --method <method>`	HTTP 方法（默认：GET）
`-d, --data <json>`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

685,800 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

240,900 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

193,000 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

125,300 周安装

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

X402 使用 USDC 原子单位（6 位小数）：

原子单位	美元
1000000	$1.00
100000	$0.10
50000	$0.05
10000	$0.01

重要提示：对于包含 $ 的金额，请始终使用单引号包裹，以防止 bash 变量扩展（例如使用 '$1.00' 而不是 $1.00）。

在构建命令之前，请验证所有用户提供的值，以防止 shell 注入：

url：必须是有效的 URL，以 https:// 或 http:// 开头。如果包含空格、分号、管道符、反引号或 shell 元字符，则拒绝。
data (-d)：必须是有效的 JSON。始终使用单引号包裹以防止 shell 扩展。
max-amount：必须是正整数（^\d+$）。

请勿将未经验证的用户输入传递给命令。

# 发起 GET 请求（自动支付）
npx awal@2.0.3 x402 pay https://example.com/api/weather

# 发起带请求体的 POST 请求
npx awal@2.0.3 x402 pay https://example.com/api/sentiment -X POST -d '{"text": "I love this product"}'

# 限制最大支付金额为 $0.10
npx awal@2.0.3 x402 pay https://example.com/api/data --max-amount 100000

必须已授权（使用 npx awal@2.0.3 status 检查，参见 authenticate-wallet 技能）
钱包必须有足够的 USDC 余额（使用 npx awal@2.0.3 balance 检查）
如果您不知道端点 URL，请先使用 search-for-service 技能查找服务

"Not authenticated" - 请先运行 awal auth login <email>，或参见 authenticate-wallet 技能
"No X402 payment requirements found" - URL 可能不是 x402 端点；请使用 search-for-service 查找有效端点
"Insufficient balance" - 请向钱包充值 USDC；参见 fund 技能

🇺🇸English

Making Paid x402 Requests

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

Confirm wallet is initialized and authed

npx awal@2.0.3 status

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

Command Syntax

npx awal@2.0.3 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.0.3 x402 pay https://example.com/api/weather

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

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

Prerequisites

Must be authenticated (npx awal@2.0.3 status to check, see authenticate-wallet skill)
Wallet must have sufficient USDC balance (npx awal@2.0.3 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

Weekly Installs

1.4K

Repository

coinbase/agenti…t-skills

GitHub Stars

First Seen

Feb 10, 2026

Security Audits

Gen Agent Trust HubWarn SocketWarn SnykWarn

Installed on

codex1.2K

opencode1.2K

gemini-cli1.2K

github-copilot1.2K

kimi-cli1.1K

amp1.1K