Pay For Service

1---2name: pay-for-service3description: 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, use a paid service, or pay for an API call. Use after finding a service with search-for-service.4user-invocable: true5disable-model-invocation: false6allowed-tools: ["Bash(npx awal@2.0.3 status*)", "Bash(npx awal@2.0.3 balance*)", "Bash(npx awal@2.0.3 x402 pay *)"]7---8 9# Making Paid x402 Requests10 11Use the `npx awal@2.0.3 x402 pay` command to call paid API endpoints with automatic USDC payment on Base.12 13## Confirm wallet is initialized and authed14 15```bash16npx awal@2.0.3 status17```18 19If the wallet is not authenticated, refer to the `authenticate-wallet` skill.20 21## Command Syntax22 23```bash24npx awal@2.0.3 x402 pay <url> [-X <method>] [-d <json>] [-q <params>] [-h <json>] [--max-amount <n>] [--json]25```26 27## Options28 29| Option                  | Description                                        |30| ----------------------- | -------------------------------------------------- |31| `-X, --method <method>` | HTTP method (default: GET)                         |32| `-d, --data <json>`     | Request body as JSON string                        |33| `-q, --query <params>`  | Query parameters as JSON string                    |34| `-h, --headers <json>`  | Custom HTTP headers as JSON string                 |35| `--max-amount <amount>` | Max payment in USDC atomic units (1000000 = $1.00) |36| `--correlation-id <id>` | Group related operations                           |37| `--json`                | Output as JSON                                     |38 39## USDC Amounts40 41X402 uses USDC atomic units (6 decimals):42 43| Atomic Units | USD   |44| ------------ | ----- |45| 1000000      | $1.00 |46| 100000       | $0.10 |47| 50000        | $0.05 |48| 10000        | $0.01 |49 50**IMPORTANT**: Always single-quote amounts that use `$` to prevent bash variable expansion (e.g. `'$1.00'` not `$1.00`).51 52## Input Validation53 54Before constructing the command, validate all user-provided values to prevent shell injection:55 56- **url**: Must be a valid URL starting with `https://` or `http://`. Reject if it contains spaces, semicolons, pipes, backticks, or shell metacharacters.57- **data (-d)**: Must be valid JSON. Always wrap in single quotes to prevent shell expansion.58- **max-amount**: Must be a positive integer (`^\d+$`).59 60Do not pass unvalidated user input into the command.61 62## Examples63 64```bash65# Make a GET request (auto-pays)66npx awal@2.0.3 x402 pay https://example.com/api/weather67 68# Make a POST request with body69npx awal@2.0.3 x402 pay https://example.com/api/sentiment -X POST -d '{"text": "I love this product"}'70 71# Limit max payment to $0.1072npx awal@2.0.3 x402 pay https://example.com/api/data --max-amount 10000073```74 75## Prerequisites76 77- Must be authenticated (`npx awal@2.0.3 status` to check, see `authenticate-wallet` skill)78- Wallet must have sufficient USDC balance (`npx awal@2.0.3 balance` to check)79- If you don't know the endpoint URL, use the `search-for-service` skill to find services first80 81## Error Handling82 83- "Not authenticated" - Run `awal auth login <email>` first, or see `authenticate-wallet` skill84- "No X402 payment requirements found" - URL may not be an x402 endpoint; use `search-for-service` to find valid endpoints85- "Insufficient balance" - Fund wallet with USDC; see `fund` skill