Making Paid x402 Requests

npx awal@latest x402 pay

Confirm wallet is initialized and authed

npx awal@latest status

authenticate-wallet

Command Syntax

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

Options

-X, --method <method>

-d, --data <json>

-q, --query <params>

-h, --headers <json>

--max-amount <amount>

--correlation-id <id>

--json

USDC Amounts

$

'$1.00'

$1.00

Examples

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

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

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

Prerequisites

• Must be authenticated (

  npx awal@latest status

  to check, see

  authenticate-wallet

  skill)
• Wallet must have sufficient USDC balance (

  npx awal@latest 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