Awesome X402

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

Contents

• 🎯 Quick Start - Become an x402 Champion
• 📚 Official Resources
• 📖 Protocol Documentation
• 🚀 Quickstart Guides
• ⚙️ Protocol Implementations
• 🏭 Production Implementatdions
• 🛠️ 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-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