x402 Quick Start
SkillSkill
The five-step pattern for making your first x402-gated API call. Parse, pay, retry.
About
x402 is an HTTP payment protocol. When a client requests a gated endpoint, the server returns a 402 Payment Required response containing the payment terms: USDC amount, destination wallet address, and network (Base or Solana).
The client pays on-chain, submits proof to a facilitator, and retries the request with a payment token in the header. The server verifies and responds with 200.
The handshake has five steps. This skill walks your agent through each one: parse the 402 response fields, display them for operator review, construct the payment submission, retrieve the payment token from the facilitator, and format the retry request. Every step is documented with exact field names and decision rules, including what to do when the facilitator's scheme differs from the standard pattern.
This skill is the entry point for working with x402. It covers the payment pattern only. For monitoring revenue across x402 endpoints (USDC totals, success rates, payer patterns, pricing optimization), see x402 Revenue Dashboard ($29 on ClawMart). For building multi-step data pipelines through x402-gated sources, see Data Pipeline Builder ($89 on ClawMart).
Core Capabilities
- Parse 402 Payment Required response fields: amount
- network
- wallet address
- expiry
- payment ID
- facilitator endpoint
- Display payment details for operator review before any payment is initiated
- Format the facilitator verification request with transaction hash and payment ID
- Format the retry request with the correct payment proof header (X-Payment or Authorization: Bearer)
- Report second-402 failures with enough context to diagnose the cause (latency
- expiry
- mismatch)
- Handle both Base (ERC-20 USDC) and Solana (SPL token) network contexts
- Works with any x402 facilitator — field names and header format are confirmed from the operator
- not hardcoded
Customer ratings
0 reviews
No ratings yet
- 5 star0
- 4 star0
- 3 star0
- 2 star0
- 1 star0
No reviews yet. Be the first buyer to share feedback.
One-time purchase
$0
By continuing, you agree to the Buyer Terms of Service.
Creator
The Meridian Lab
The Meridian Lab is an anti-intelligence lab building the trust and defense layer of the autonomous internet
The Meridian Lab is an anti-intelligence lab building the trust and defense layer of the autonomous internet.
View creator profile →Details
- Type
- Skill
- Category
- Engineering
- Price
- $0
- License
- One-time purchase
Compatible With
Any OpenClaw agent, Claude Code, Claude Desktop, any markdown-skill-compatible framework with HTTP tool access
Required Tools
HTTP tool access, x402-compatible wallet or facilitator
Works great with
Personas that pair well with this skill.
Greyline: Sentinel
Adversarial Security Agent
An adversarial-by-default agent persona. Treats external data as evidence, flags anomalies without being asked, and audits before it acts.
$49
The AI Agent Team Blueprint — Build a 5-Agent Revenue Squad
Persona
Complete architecture for a multi-agent team on OpenClaw. Orchestrator + 5 specialists. SOUL.md templates, model routing, delegation patterns, cost optimization.
$39
Quinn Mason: Your AI CTO
Persona
Turns strategy into working systems and tells you, truthfully, what is built, what is verified, and what is still a sketch.
$49