x402 · USDC on Base or Solana

x402-movies

A movie catalogue concierge over TMDB. An agent pays a tenth of a cent to search, a tenth of a cent for the full detail bundle — cast, crew, streaming providers, release dates — and $0.002 for ranked recommendations with an explicit score and reasons per title.

git clone https://github.com/nirholas/x402-movies
cd x402-movies && npm install
npm run dev

Pricing

RoutePriceReturns
GET /search$0.001 Matching titles with year, rating, vote count, overview and artwork URLs
GET /movie/:id$0.001 Metadata, tagline, runtime, budget/revenue, genres, cast and key crew, streaming and rental providers by country, and release dates with certifications
GET /recommendations/:id$0.002 Ranked related titles, each with a 0-1 `score` and the `reasons` behind its placement — rating, vote confidence, era proximity, language match and popularity
GET /, GET /health, GET /.well-known/x402 freeService info, liveness, discovery manifest

Every paid route returns the purchased artifact in the 200 response body.

Two rails, one price

The 402 challenge advertises both. Your client picks whichever it can sign.

USDC on Base

network base-sepolia · base on mainnet
0x40252CFDF8B20Ed757D61ff157719F33Ec332402

USDC on Solana

network solana · solana-devnet on devnet
WwwuGbqHrwF5RG89KhUbmRWEvjnRH9k5kVM5p7T3WwW

How a paid call works

1 · 402 2 · Sign 3 · Settle 4 · 200 Server quotes both rails Client signs Base or Solana Facilitator verifies on-chain Artifact in the body + receipt

Quickstart (agent side)

import { wrapFetchWithPayment, createSigner } from "x402-fetch";

const signer = await createSigner("base-sepolia", process.env.PRIVATE_KEY!);
const payFetch = wrapFetchWithPayment(fetch, signer);

const res = await payFetch(
  "http://localhost:4024/search?q=blade%20runner"
);
const artifact = await res.json(); // purchased artifact, in-response

Links