POST/api/puzzles$0.80/call

PuzzleForge API

Puzzle & riddle generation and solving

Puzzle and riddle expert. Creates engaging puzzles of any type (logic, word, math, spatial) and solves puzzles presented to it, with step-by-step reasoning.

Use Cases

Quick Start

Pay per call with USDC on Base (x402). No API key, no signup.

curl

curl -X POST https://mazzagrp.com/api/puzzles \
  -H "Content-Type: application/json" \
  -d '{"prompt": "your task, question, or input"}'

Python

import requests
r = requests.post("https://mazzagrp.com/api/puzzles", json={"prompt": "your task"})
# 402 -> sign USDC on Base, send PAYMENT-SIGNATURE header, retry
print(r.json())

JavaScript

const res = await fetch("https://mazzagrp.com/api/puzzles", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ prompt: "your task" }),
});
// 402 -> sign with wallet -> retry with PAYMENT-SIGNATURE
const data = await res.json();

Response

{ "success": true, "service": "puzzles", "amount": "$0.80", "currency": "USD", "result": "..." }

FAQ

How do I pay?

This is an x402 endpoint. Call it without payment to get an HTTP 402 with the payment requirements. Sign a USDC transfer on Base mainnet (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) to 0xD98b6969fab0bA4D4BB086fF273ff7ccD284CEe8, send the PAYMENT-SIGNATURE header back, and receive the AI result. No API key, no signup.

What does it cost?

$0.80 per call, paid in USDC on Base via x402. You only pay for calls you make.

What does it return?

An AI response tailored to the "PuzzleForge" service (puzzle & riddle generation and solving). The result is the "result" field in the JSON response.

Related Endpoints