Awesome X402

⚡ The Ultimate x402 Resource Hub - Everything 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.

Contents

• 🎯 Quick Start - Become an x402 Champion
• 📚 Official Resources
• 📖 Protocol Documentation
• 🚀 Quickstart Guides
• ⚙️ Protocol Implementations
• 🏭 Production Implementations
• 🛠️ SDKs & Client Libraries
• 🔧 Server Frameworks & Middleware
• 🏗️ Facilitators
• 💡 Example Applications
• 🎨 Use Cases & Patterns
• 🤖 AI Agent Integration
• 🔨 Tools & Utilities
• 🧪 Testing & Development
• 📚 Tutorials & Learning Resources
• 🎥 Videos & Talks
• 📝 Articles & Blog Posts
• 👥 Community
• 🌟 Ecosystem Projects
• 📊 Ecosystem Market Data
• 🚀 Migration Guides
• 🔒 Security & Audits
• 🔗 Related Protocols
• 🤝 Contributing
• 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 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-express - Express.js middleware example.

Python

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

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

• 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.
• 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.

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 (🚀 Built with ❤️ by xpay✦

Helping the agentic community get paid and pay safely!

If this helped you, please ⭐ star the repo and share it!

Official x402 Website • Protocol Repo • Documentation • Discord • Twitter