Endpoint Scanner
Probe API endpoints and detect HTTP 402 Payment Required responses with x402-compatible headers.
Experimental · Base Network · v0.2
x402 CLI
The terminal gateway for x402-powered APIs on Base.
Scan endpoints, inspect HTTP 402 payment requirements, preview USDC-based API payments, and interact with x402-powered services directly from a terminal-inspired interface.
x402cli — zsh
$
402 Payment Required detected
Network: Base
Asset: USDC
Price: 0.001 USDC
Resource: /weather
Mode: x402
Scanner
Endpoint Scanner
Simulate an x402 endpoint scan. No real network requests are made — output is generated from mock data to preview CLI behavior.
URL
x402cli scan — output
$ x402cli scan https://api.x402cli.xyz/weather
Ready. Click "Scan Endpoint" to simulate.
Overview
What is x402 CLI?
x402 CLI is an experimental web and CLI concept designed to help developers understand and test x402-powered API flows. It provides a terminal-style interface for exploring HTTP 402 Payment Required responses, USDC payment requirements on Base, and the emerging ecosystem of pay-per-request APIs built for developers and AI agents.
Purpose
Why x402cli.xyz?
x402cli.xyz is an experimental discovery layer and terminal playground for x402-powered APIs on Base. It exists to help developers, API builders, and AI agents explore pay-per-request workflows before production integration.
Not an official x402 CLI. This is an independent project built for ecosystem exploration and developer education.
Not affiliated with Coinbase or Base. No official endorsement. References are for compatibility and documentation only.
Focused on Base, USDC, HTTP 402, API discovery, and agent-ready workflows. Built for developers who need clarity on x402 payment flows.
$ x402cli.xyz
─────────────────────
layer : discovery + terminal
network : Base
asset : USDC
protocol: HTTP 402 / x402
status : experimental
→ agent-ready · dev-first
Features
Core Features
Payment Requirement Inspector
Parse and display payment requirements including network, asset, amount, and resource metadata.
Base + USDC Preview
Preview how USDC-based micropayments on Base would apply to a given API request before execution.
x402 API Registry
Browse a curated preview of x402-compatible APIs with pricing, endpoints, and availability status.
Agent-ready Workflow
Designed for AI agents and automation tools that need structured payment flow discovery.
Developer-first Docs
Clear documentation covering x402 concepts, example commands, and planned CLI behavior.
Registry
x402 API Registry Preview
Browse demo API entries. Filter by category to preview how the public registry will work.
| API Name | Category | Price | Network | Status | Action |
|---|---|---|---|---|---|
| Weather API | Data | 0.001 USDC per request | Base | Demo | |
| Market Data API | Finance | 0.002 USDC per request | Base | Demo | |
| Agent Tool API | AI Agent | 0.005 USDC per request | Base | Demo | |
| Content API | Content | 0.001 USDC per request | Base | Demo |
Weather API
0.001 USDC per request
Data · Base · Demo
Market Data API
0.002 USDC per request
Finance · Base · Demo
Agent Tool API
0.005 USDC per request
AI Agent · Base · Demo
Content API
0.001 USDC per request
Content · Base · Demo
Workflow
How It Works
01
Request API endpoint
Send a request to any API endpoint that may require payment per call.
02
402 Payment Required
The endpoint returns HTTP 402 with x402 payment requirement headers.
03
Inspect requirements
Parse network, asset, amount, and scheme from the 402 response payload.
04
Prepare paid flow
Prepare the Base / USDC payment flow and retry the request with proof of payment.
Interactive
Command Preview
Switch between commands to preview planned CLI behavior. See full command docs for details.
$ x402cli scan https://api.x402cli.xyz/weather
Audience
Built for
</>
Developers
Integrate pay-per-request APIs into your stack with clear visibility into x402 payment flows and Base USDC requirements.
[AI]
AI Agents
Give autonomous agents a structured way to discover, inspect, and prepare payments for x402-powered services.
{API}
API Builders
Understand how your API appears to clients when returning HTTP 402 and listing in the x402 registry.
Changelog
Release History
Honest progress tracking for an early-stage experimental project.
v0.2
Registry preview and endpoint scanner mock current
Live terminal demo, registry filters, submit API form, commands page, and visual polish.
v0.1
Website launch, docs, terminal preview
Initial site, documentation, interactive terminal tabs, and roadmap.
v0.3
Planned x402 response parser planned
Real endpoint probing and structured parsing of x402 payment requirement payloads.
v0.4
Planned Base / USDC payment flow research planned
Research and prototype USDC micropayment flows on Base for pay-per-request APIs.
Roadmap
Roadmap Preview
Phase 1
Website & terminal preview
Launch site, documentation, and interactive terminal UI preview.
Phase 2
Real x402 endpoint detection
Endpoint scanner prototype and x402 response parser.
Phase 3
Base + USDC payment flow research
Research and prototype USDC micropayment flows on Base.
Phase 4
Public registry for x402 APIs
Submission system for listing x402-compatible API endpoints.
Phase 5
Agent mode and automation support
Agent mode for AI tools and automation workflows.