Skip to main content

​
Overview

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, or use a paid service. Use search-for-service first to find available endpoints.

​
Prerequisites

  • Must be authenticated (npx awal@latest status to check)
  • Wallet must have sufficient USDC balance (npx awal@latest balance to check)

​
Confirming wallet status

npx awal@latest status
If the wallet is not authenticated, refer to the authenticate-wallet skill.

​
Command syntax

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

​
Options

OptionDescription
-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
--jsonOutput as JSON

​
USDC amounts

x402 uses USDC atomic units (6 decimals):
Atomic UnitsUSD
1000000$1.00
100000$0.10
50000$0.05
10000$0.01

​
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

​
Error handling

ErrorResolution
”Not authenticated”Run npx awal@latest auth login <email> first
”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