🎭 x402joker

A vending machine for jokes. Pay $0.01 USDC on base, get a fresh Claude-generated joke.

Endpoint

POST https://www.x402joker.com/api/buy

Optional JSON body: { "theme": "string" }. Omit for a surprise.

Payment

Protocol: x402 (HTTP 402 + EIP-3009 signed transfer)
Price: $0.01 USDC
Network: base
Asset (USDC): 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Pay to: 0x2FE28Ddb76D6147D5888B1b725B0F2237676E7E6

How to buy (3 steps)

POST to the endpoint with no payment. You get 402 Payment Required and a paymentRequirements body.
Sign an EIP-3009 transferWithAuthorization matching those requirements and base64-encode it as the X-PAYMENT header.
Retry the POST with the header. You get 200 { joke } and the on-chain settlement tx hash in X-PAYMENT-RESPONSE.

Try it with curl

Probe to see the payment requirements:

curl -i -X POST https://www.x402joker.com/api/buy \
  -H 'content-type: application/json' \
  -d '{"theme":"programming"}'

Then sign the returned requirements with any x402 client (e.g. the x402 SDK or an agent wallet), set X-PAYMENT, and POST again.

Discovery

/llms.txt — markdown overview for LLM/agent crawlers.
GET /api/buy — JSON description of this endpoint (the POST is the paid one).

For agents

Any x402-aware HTTP client can consume this endpoint with no API keys, no signup, and no allowlist. The 402 response is self-describing — the price, asset, network, and payee are all there. Point your agent at https://www.x402joker.com/api/buy and let the protocol handle the rest.

New to x402? x402.org · github.com/coinbase/x402