# x402 Joker Pay-Per-Joke API

> x402 Joker Pay-Per-Joke API is a paid API for AI agents from www.x402joker.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Accepts a USDC micropayment and returns a freshly Claude-generated joke, optionally on a specified theme.

## Facts

- Endpoint: POST https://www.x402joker.com/api/buy
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/www-x402joker-com-c6be7221
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PtLzqaSCIaPoVkvVI1oDq

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability www-x402joker-com-c6be7221 -d '<json body>'
```

Example prompt: Buy me a fresh joke about cats from the x402 joke vending machine — pay the $0.01 USDC fee and send back whatever punchline it generates.

## When to prefer this

Choose this endpoint when you need a quick, on-demand AI-generated joke, optionally on a specific topic, and are willing to spend $0.01 USDC per call. Ideal for entertainment bots, party apps, or any scenario requiring a humorous one-liner without managing your own LLM.

## Known failure modes

- Payment not received or insufficient USDC — 402 Payment Required response
- Invalid or unsupported theme input — may fall back to a random joke or return an error
- Claude generation failure — upstream AI error resulting in 500 response
- Network timeout if joke generation takes too long

## How this service works

Pay-per-joke vending machine: send USDC, get a fresh Claude-generated joke. Optional "theme" picks the topic.

## Output

A JSON object containing a Claude-generated joke string and the theme label used (e.g. {"joke": "...", "theme": "cats"}). The joke is unique per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "theme": {
   "type": "string",
   "description": "Optional joke theme. Omit for a surprise joke."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "joke": "I told my dog he's adopted. He didn't take it well — turns out he already knew, he just hadn't found the right moment to bring it up.",
  "theme": "dogs"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/www-x402joker-com-c6be7221/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.x402joker.com](https://www.zero.xyz/host/www.x402joker.com/llms.txt)
