Reference

Commands

Planned CLI command reference for x402 CLI. The installable CLI package is not yet published — the current version provides web-based terminal simulation and public documentation.

● CLI package planned · Web simulation active

Overview

x402 CLI is designed as a terminal-first tool for working with x402-powered APIs on Base. These commands represent the planned interface. You can preview scan behavior on the homepage scanner.

x402cli scan <url>

scan

Probe an API endpoint and detect HTTP 402 Payment Required responses. Outputs a summary of network, asset, price, resource path, and x402 mode status.

x402cli scan https://api.x402cli.xyz/data
x402cli inspect <url>

inspect

Parse and display full x402 payment requirement fields from a 402 response — including scheme, network, asset, amount, payTo address, and resource metadata.

x402cli inspect https://api.x402cli.xyz/data
x402cli registry

registry

List x402-compatible APIs from the public registry with pricing, network, category, and availability status. Browse the registry preview on the web.

x402cli registry
x402cli demo

demo

Run a step-by-step simulation of the x402 payment flow — request, 402 response, requirement parsing, USDC preparation, and authenticated retry. No real payment is executed.

x402cli demo

Current status

The CLI package is planned. Current version focuses on:

  • Web-based terminal simulation on x402cli.xyz
  • Public documentation and command reference
  • Registry preview with demo API entries
  • Endpoint scanner mock with preset endpoints

When the CLI is published, installation instructions will appear here and on the docs page.

Try it now

Use the interactive command preview on the homepage or run a live scan simulation:

Try Scanner