Quick Start

Get a USDC-gated API route live in under 5 minutes.

1. Install the package

   npm install @ace_won/x402
   
2. Wrap your route

   app/api/your-endpoint/route.ts

   import { withPayment } from "@ace_won/x402";
   import { NextRequest, NextResponse } from "next/server";
   
   async function handler(req: NextRequest) {
     return NextResponse.json({ data: "your content here" });
   }
   
   // Requires 0.001 USDC to access
   export const GET = withPayment({ amount: "0.001" }, handler);
   
3. Test it

   curl -i https://your-app.vercel.app/api/your-endpoint
   

   Returns 402 Payment Required with a Payment-Required header.

4. List on the marketplace

   Submit your endpoint at conduitpay.xyz/marketplace/submit so AI agents and developers can discover it.

Requirements

Requirement	Version
Next.js	14+
viem	v2+ (peer dependency)
Node.js	18+