COINBASE X402 PROTOCOL
X402COMMERCE
Pay-per-request commerce APIs powered by USDC micropayments on Solana. No API keys. No subscriptions. Just cryptographic proof of payment.
Request
402 Challenge
Sign & Pay
Response
PURCH NOWTHE API
Six endpoints. Search, shop, buy physical products. Browse, purchase, and download digital assets from the Vault. All gated by x402 micropayments.
GET
/x402/searchProduct search with filters$0.01POST
/x402/shopAI-powered natural language search$0.10POST
/x402/buyOne-command checkout (dynamic pricing)product priceGET
/x402/vault/searchSearch digital assets (skills, knowledge, personas)$0.01POST
/x402/vault/buyPurchase a digital asset (dynamic pricing)item priceGET
/x402/vault/download/:idDownload purchased file$0.01Base URL: https://api.purch.xyz
SHOP API
Natural language in, curated products out. Your agent describes what it needs, Purch searches 1B+ products and returns matches.
POST
https://api.purch.xyz/x402/shopRequest
{
"message": "comfortable running shoes for marathon training under $150"
}Response
{
"reply": "Here are some great marathon training shoes...",
"products": [
{
"asin": "B0CXYZ1234",
"title": "Nike Pegasus 41",
"price": 129.99,
"currency": "USD",
"rating": 4.7,
"reviewCount": 12453,
"imageUrl": "https://...",
"source": "amazon"
}
]
}BUY API
One POST, one payment. The x402 price equals the product total including tax and shipping. No transaction signing needed.
POST
https://api.purch.xyz/x402/buyRequest
{
"asin": "B0CXYZ1234",
"email": "buyer@example.com",
"shippingAddress": {
"name": "John Doe",
"line1": "123 Main St",
"city": "San Francisco",
"state": "CA",
"postalCode": "94102",
"country": "US"
}
}Response
{
"orderId": "550e8400-e29b-41d4-a716-446655440000",
"status": "processing",
"product": {
"title": "Nike Pegasus 41",
"price": { "amount": "129.99", "currency": "USD" }
},
"totalPrice": { "amount": "136.49", "currency": "usdc" }
}WHY X402?
No API Keys
Payment is the authentication. No signup, no rate limits, no key management. Just pay and use.
Instant Settlement
USDC on Solana means sub-second finality. No invoices, no payment delays, no chargebacks.
Pay Per Use
True micropayments. Pay exactly for what you use, when you use it. Perfect for AI agents.
Coinbase Backed
Built on Coinbase's x402 protocol. Enterprise-grade infrastructure with the simplicity of HTTP.
FIND ME ON MOLTBOOK
Moltbook is the social network for AI agents. Purch is there, ready for agent-to-agent commerce.
Purch
@PurchWHAT AGENTS CAN BUILD
Gift Agents
"Find a birthday gift for a 30-year-old who loves hiking" — curated options, ready to ship.
Home Automation
Smart home agents that reorder supplies when inventory runs low.
Personal Stylists
Fashion agents that source outfits based on style preferences and events.
Research Agents
Compare products, aggregate reviews, and surface the best options for any category.
INTEGRATE IN MINUTES
Use the x402 SDK or make raw HTTP requests. Works with any language, any framework.
1
Connect Wallet
Any Solana wallet with USDC. Phantom, Solflare, or programmatic keypairs for agents.
2
Make Request
Send your API request. If payment is required, you'll get a 402 response with a payment challenge.
3
Sign & Retry
Sign the payment with your wallet and retry with the X-PAYMENT header. Done.
npm install @x402/fetch @x402/svmor use the x402 SDK for automatic payment handlingTHE FUTURE OFAI COMMERCE
Join the x402 ecosystem. Build agents that can search, shop, and transact — all with cryptographic payments.