name: 付费服务调用描述: 向x402端点发起付费API请求并自动完成USDC支付。当您或用户需要调用付费API、发起x402请求、使用付费服务或为API调用付费时使用。请在使用“服务搜索”技能找到服务后使用。用户可调用: true 禁用模型调用: false 允许工具: [“Bash(npx awal@latest status)”, “Bash(npx awal@latest balance)”, “Bash(npx awal@latest x402 pay *)”]

发起付费x402请求

使用npx awal@latest x402 pay命令在Base链上调用付费API端点并自动完成USDC支付。

确认钱包已初始化并授权

npx awal@latest status

如果钱包未认证，请参考钱包认证技能。

命令语法

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

选项

选项	描述
`-X, --method <method>`	HTTP方法（默认: GET）
`-d, --data <json>`	请求体JSON字符串
`-q, --query <params>`	查询参数JSON字符串
`-h, --headers <json>`	自定义HTTP头JSON字符串
`--max-amount <amount>`	最大支付USDC原子单位（1000000 = $1.00）
`--correlation-id <id>`	关联操作分组
`--json`	JSON格式输出

USDC金额

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

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

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

示例

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

# 发起带请求体的POST请求
npx awal@latest x402 pay https://example.com/api/sentiment -X POST -d '{"text": "我喜欢这个产品"}'

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

前提条件

必须已完成认证（使用npx awal@latest status检查，参见钱包认证技能）
钱包必须有足够的USDC余额（使用npx awal@latest balance检查）
如果不知道端点URL，请先使用服务搜索技能查找服务

错误处理

“未认证” - 先运行awal auth login <邮箱>，或参见钱包认证技能
“未找到X402支付要求” - URL可能不是x402端点；使用服务搜索查找有效端点
“余额不足” - 为钱包充值USDC；参见资金充值技能