Awesome X402

Awesome X402 [](https://awesome.re)

> ⚡ The Ultimate x402 Resource Hub - Everythng you need to build internet-native payments using HTTP 402. Perfect for AI agents, APIs, and micropayments. Build paywalls, monetize services, and enable autonomous agent payments with crypto/USDC. Zero fees, 2-second settlement.

[](https://github.com/xpaysh/awesome-x402)

Contents

• [🎯 Quick Start - Become an x402 Champion](#-quick-start---become-an-x402-champion)
• [📚 Official Resources](#-official-resources)
• [📖 Protocol Documentation](#-protocol-documentation)
• [🚀 Quickstart Guides](#-quickstart-guides)
• [⚙️ Protocol Implementations](#-protocol-implementations)
• [🏭 Production Implementatdions](#-production-implementations)
• [🛠️ SDKs & Client Libraries](#-sdks--client-libraries)
• [🔧 Server Frameworks & Middleware](#-server-frameworks--middleware)
• [🏗️ Facilitators](#-facilitators)
• [💡 Example Applications](#-example-applications)
• [🎨 Use Cases & Patterns](#-use-cases--patterns)
• [🤖 AI Agent Integration](#-ai-agent-integration)
• [🔨 Tools & Utilities](#-tools--utilities)
• [🧪 Testing & Development](#-testing--development)
• [📚 Tutorials & Learning Resources](#-tutorials--learning-resources)
• [🎥 Videos & Talks](#-videos--talks)
• [📝 Articles & Blog Posts](#-articles--blog-posts)
• [👥 Community](#-community)
• [🌟 Ecosystem Projects](#-ecosystem-projects)
• [📊 Ecosystem Market Data](#-ecosystem-market-data)
• [🚀 Migration Guides](#-migration-guides)
• [🔒 Security & Audits](#-security--audits)
• [🔗 Related Protocols](#-related-protocols)
• [🤝 Contributing](#-contributing)
• [Awesome Lists](#awesome-lists)

The x402 protocol enables instant Blockchain payments over HTTP using the 402 "Payment Required" status code. This is your complete guide to mastering x402 and building the future of agent payments.

🚀 Start building in 5 minutes | ⚡ 2-second settlement | 💰 USDC on Base

---

🎯 Quick Start - Become an x402 Champion

New to x402? Follow this path to mastery:

1. 5-Minute Quickstart - Accept your first payment.
2. Choose Your Stack - Find your language/framework.
3. Copy an Example - Working code you can run immediately.
4. Join the Community - Get help from other builders.

For AI Agents: Start with [MCP Integration](#model-context-protocol-mcp) to enable Claude/other agents to make autonomous payments.

---

📚 Official Resources

Core resources from the x402 protocol maintainers.

• x402 Protocol Specification - Official open-source protocol implementation by Coinbase.
• x402 Foundation - Protocol foundation website with overview and documentation.
• x402 Whitepaper - Technical deep dive into protocol architecture.
• Coinbase Developer Platform Docs - Complete implementation guide and API reference.
• Protocol Specifications - Detailed technical specifications.
• Payment Schemes - Different payment flow types.
• EVM Implementation - Ethereum Virtual Machine specifics.

📖 Protocol Documentation

Essential documentation for understanding and implementing x402.

• How x402 Works - Complete payment flow explanation with diagrams.
• Payment Requirements Schema - JSON structure for payment requests.
• Payment Payload Format - Client payment submission format.
• Verification & Settlement - Payment validation process.
• EIP-3009 TransferWithAuthorization - Gasless transfer standard used by x402.
• HTTP 402 Status Code - The long-dormant HTTP status.

🚀 Quickstart Guides

Get started with x402 in minutes.

• 5-Minute Quickstart for Sellers - Accept your first payment.
• Buyer/Client Setup - Make automated payments.
• One-Line Integration - Add payment middleware in a single line of code.
• Base Sepolia Testnet Setup - Get test USDC and start testing.
• Production Deployment Checklist - Go live on Base mainnet.

⚙️ Protocol Implementations

Official and community implementations of the x402 protocol.

Go

• coinbase/x402 ⭐ Official - Complete Go implementation.
• Core protocol types and utilities
• Payment verification and settlement logic
• Multi-chain support (Base, Base Sepolia, Ethereum, Solana)

TypeScript/JavaScript

• x402-typescript ⭐ Official - Complete TypeScript implementation.
• Core protocol types and utilities
• Payment verification and settlement logic
• Multi-chain support (Base, Base Sepolia, Ethereum, Solana)
• x402-data-api - HTTP 402 micro-payment data API with Base chain USDC payments. 16 developer data tools including email validation, DNS lookup, WHOIS, SSL check, and IP geolocation with x402 payment integration.

• x402-express - Express.js middleware example.
• hive-rosetta ⭐ Community - Open EIP-3009 transferWithAuthorization signer. Zero ethers/web3 dependency, primitives-only EIP-712. Returns wire shape {scheme: 'exact', network: 'eip155:8453', payload: {authorization, signature}}. Same package name on PyPI. (GitHub)

Python

• x402 ⭐ Official - Python SDK on PyPI.
• FastAPI middleware integration
• Requests session with auto-payments
• Payment requirement generation

• ag402 ⭐ Community - Payment layer for AI agents using x402. Wrap any API or MCP server with a USDC paywall (ag402 serve), or let agents auto-pay (ag402 run). Solana USDC, ~0.5s settlement, non-custodial, 648+ tests. Glama

• x402-pay - Call any x402 API with one API key. Routes requests through a broker that handles on-chain payment. httpx-based, optional wallet mode for direct payments. (GitHub)
• hive-rosetta ⭐ Community - Direct port of the Node hive-rosetta signer. Byte-identical EIP-712 digest across both languages. Returns {scheme, network, payload} matching CDP /verify and /settle. (GitHub)

Rust

• x402-rs ⭐ Community - Production-grade Rust implementation.
• Axum middleware
• Reqwest client wrapper
• Self-hostable facilitator
• Multi-chain support
• x402-axum - Axum web framework integration.
• x402-reqwest - Reqwest HTTP client wrapper.

🏭 Production Implementations

Real companies using x402 in production with proven scale and transaction volumes.

High-Volume Production Deployments

• Fleet x402 Microservices - Two agent-payable AI services on Base: SEO Audit ($0.05 USDC) and Competitive Intel Pack ($0.50 USDC). Instant response, zero auth required, machine-readable JSON. (Discovery)
• Arch Tools - 58 production API tools for AI agents with x402 payments built in. Web scraping, AI generation, crypto data, OCR, browser automation, MCP compatible. Patent-pending agent auth. 15+ chains supported. (GitHub)
• PayAPI Market - First marketplace for x402-powered APIs. 10 APIs, 65 endpoints: UK property data, email verification, company enrichment, postcode lookup, currency/crypto rates, screenshots, DNS intelligence, web scraping, IP geolocation, QR codes. $0.001–$0.01 USDC on Base per request. MCP server discovery. (GitHub)
• LogicNodes - Live A2A marketplace with 619 deterministic microservices payable per-call in USDC. No signup — agents pay via x402, results include SHA-256 trust hashes. 8 chains: Base, Solana, Arc, Arbitrum, Optimism, Polygon, Ethereum, World Chain. Tiers: Micro $0.001 · Basic $0.05 · Standard $0.15 · Premium $0.50 USDC. MCP: npx @logicnodez/mcp-bridge | Python: pip install logicnodes-m2m. (npm) | (PyPI) | (Agent Guide) | (llms.txt)
• Superhighway - Web search API for AI agents, live in production on Base mainnet. Five tools: search, news, images, scrape, and one-call deep research. $0.001 USDC per call. MCP-compatible: npx -y superhighway-mcp. Free API key available.
• Rug Munch Intelligence - 117 MCP tools + 19 REST API endpoints for crypto data: DexScreener, Birdeye, GMGN, Arkham, Nansen, Dune, Jupiter, DeFiLlama, and more. $0.001-$0.02 USDC per call. Multi-chain (Base + Solana), free trial (1 call/IP), OpenAPI spec, no API keys, no signup. (Discovery | OpenAPI | MCP Catalog | Solana | GitHub)
• AIsa - Leading x402 payment processor with 10.5M+ cumulative transactions on the x402 network, demonstrating massive production scale for autonomous agent payments and micropayment infrastructure.
• Bitget - Major cryptocurrency exchange integrating x402 for seamless payment flows, enabling instant settlements and gasless transfers for trading operations.
• Stratalize — 100+ attested financial, healthcare, real estate, and governance intelligence tools with x402 micropayments on Base. Ed25519-signed outputs on every synthesis. $0.02–$1.00 USDC per tool call. MCP registry: com.stratalize. (x402.json)
• Coinbase Developer Platform - Official CDP implementation processing hundreds of thousands of transactions weekly with enterprise-grade reliability and 2-second settlement times.
• Cloudflare Workers - Edge computing platform with x402 integration serving global distributed payment verification at scale across 300+ data centers.
• GigSoul AI Research Agent - 23-endpoint AI research API for consultants: SEC filings, earnings calls, competitor analysis, market research, and document intelligence. - Cloudflare Workers - Edge computing platform with x402 integration serving global distributed payment verification at scale across 300+ data centers..01 USDC per call on Base mainnet. Wallet: x2b6c16fb557291b98222a570526ff2430848b723. (OpenAPI | .well-known/x402.json)
• Zuluworks AI — Sovereign Shaka PQC-Shield Factory - Autonomous A2A factory on Cloudflare Workers selling 5 post-quantum-hardened agent services via x402 USDC on Base L2: quantum-shield ($0.10, ML-KEM-768 PQC tunnel — NIST FIPS 203), kya ($0.01, agent trust scoring), browser-rendering ($0.03, headless browser extraction), memory ($0.05, semantic recall on a PQC knowledge index), workers-ai ($0.02, Llama 3.1 inference). All settlement routed through Coinbase CDP facilitator for Bazaar indexing. (Agent Card | Bazaar Manifest | MCP | Sitemap)
• Suede Agent Studio - Visual agent-flow builder that publishes flows as pay-per-call x402 endpoints (USDC on Base). Machine-readable catalog at /api/catalog; each agent exposes /.well-known/x402, /.well-known/agent-card, and /a2a. Two live agents: Daily Lyric Drop ($0.10 USDC) and The Ownership Loop ($0.25 USDC).
• Agent402 - Open-source, self-hostable x402 + MCP server with ~1,100 deterministic web tools: browser rendering, web search, PDF/image/OCR/audio, geo, live data (FX, weather, USGS, gov-data), network truth (DNS/TLS/WHOIS), crypto/x402 helpers, ~1,040 pure-CPU utilities. Dual-rail: free via proof-of-work, paid via USDC on Base/Polygon/Arbitrum (x402 v2 with Bazaar discovery). No LLM in the serving path — every tool re-tested against its own example before each release. Ships a hosted MCP connector (/mcp), an open x402 index (Find · Route · Leaderboard — the first public on-chain ranking of x402 sellers by settled USDC volume), and the agent402-tollbooth pay-per-crawl gate for the publisher side. MIT. (MCP) (OpenAPI) (Discovery) (GitHub)

• GoldBean API — 146+ AI endpoints including Baidu OCR, Translation, TTS, LLM Chat with x402 micropayments on Base. From ### Production Success Metrics.01/call for premium AI. MCP server at mcpize.com/mcp/goldbean. (GitHub)

Production Success Metrics

Key Performance Indicators:

• 10.5M+ transactions - AIsa cumulative network volume
• 500K+ weekly transactions - Ecosystem-wide payment activity
• $180M+ market cap - Combined ecosystem valuation
• 2-second settlement - Average production payment finality
• 10,000%+ growth - Year-over-year transaction volume increase

Multi-Chain Production Support

| Chain | Status | Facilitators | Settlement | Production Examples | | ------------- | ----------- | -------------------------- | --------------- | ------------------------- | | Base | Production | Coinbase CDP, Cloudflare | Instant (2s) | AIsa, Bitget, thirdweb | | Base Sepolia | Testnet | Coinbase CDP | Instant (2s) | Development, Testing | | Ethereum | Production | Cloudflare | Deferred | Enterprise DApps | | Solana | Production | Community | Instant (`. (Discovery)

• MiroShark - Universal swarm-intelligence engine exposed as a paid API: POST a scenario to the /x402/run surface and hundreds of grounded LLM personas simulate Twitter, Reddit, and a prediction market hour-by-hour, returning an analytical report. USDC on Base via x402. ([GitHub](ht

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: xpaysh
• Source: xpaysh/awesome-x402
• License: CC0-1.0
• Homepage: https://www.x402.org/

Install and usage instructions live in the source repository linked above.