Setting the file. One moment.
Subchapter 1.8
references/x402-pay.mdMarkdown3 KBView on GitHub
Use the npx awal@2.12.1 x402 pay command to call paid API endpoints with automatic USDC payment on Base.
If the wallet is not authenticated, see references/auth.md.
npx awal@2.12.1 x402 pay <url> [-X <method>] [-d <json>] [-q <params>] [-h <json>] [--max-amount <n>] [--json]| 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 |
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).
Before constructing the command, validate all user-provided values to prevent shell injection:
https:// or http://. Reject if it contains spaces, semicolons, pipes, backticks, or shell metacharacters.^\d+$).Do not pass unvalidated user input into the command.
# Make a GET request (auto-pays)
npx awal@2.12.1 x402 pay https://example.com/api/weather
# Make a POST request with body
npx awal@2.12.1 x402 pay https://example.com/api/sentiment -X POST -d '{"text": "I love this product"}'
# Limit max payment to $0.10
npx awal@2.12.1 x402 pay https://example.com/api/data --max-amount 100000npx awal@2.12.1 status to check; see references/auth.md)npx awal@2.12.1 balance to check; see references/fund.md to top up)references/x402-search.md to find services firstreferences/auth.mdreferences/x402-search.md to find valid endpointsreferences/fund.md