Pay for Service

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

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

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

Error	Resolution
”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

GET STARTED

WALLETS

PAYMENTS

STABLECOINS

TRADING

ONCHAIN TOOLS

CUSTOMERS

WEBHOOKS

CONSUMER APIS

BUSINESS APIS

INSTITUTIONAL APIS

Overview

Prerequisites

Confirming wallet status

Command syntax

Options

USDC amounts

Examples

Error handling

​Overview

​Prerequisites

​Confirming wallet status

​Command syntax

​Options

​USDC amounts

​Examples

​Error handling

Overview

Prerequisites

Confirming wallet status

Command syntax

Options

USDC amounts

Examples

Error handling