# Curiquiz — Full Machine Manifest # Generated: 2026-11-22T04:49:26.134Z # This file is intended for AI agents, automated clients, and LLM tool-callers. > Curiquiz (https://curiquiz.com) is a premium human-curated trivia database with 1352+ questions > across 8 categories. All questions include 4 options, the correct answer index (0-based), > and an educational fun fact. --- ## Identity - Name: Curiquiz - URL: https://curiquiz.com - Type: Trivia / Quiz data provider - Question format: Multiple-choice (4 options, 1 correct) - Languages: English - Contact: https://curiquiz.com/contact --- ## Machine API (x402 Micropayment Protocol) Agents can purchase structured quiz data on a per-request basis using USDC on Base Mainnet. No accounts, no API keys, no PII collection. ### Protocol - Standard: x402 (HTTP 402 Payment Required) - Network: Base Mainnet (CAIP-2: eip155:8453) - Token: USDC (contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) - Facilitator: https://api.cdp.coinbase.com/platform/v2/x402 (Coinbase CDP) - Recipient wallet: 0x89C573537177A981f4BC9e27c5c17F44e93320C7 ### Endpoints & Pricing #### Full Bundle — All Categories Endpoint : GET https://curiquiz.com/api/quizzes Price : 0.20 USDC (200000 atomic units) Returns : JSON with all 1352+ questions across 8 categories Free hook: GET https://curiquiz.com/api/quizzes?sample=true → 10 random questions, no payment #### Per-Category Endpoints Endpoint : GET https://curiquiz.com/api/quizzes/{category} Price : 0.05 USDC (50000 atomic units) Returns : JSON with all questions for that category Free hook: GET https://curiquiz.com/api/quizzes/{category}?sample=true → 5 random questions, no payment #### AI Model Benchmark & Ground-Truth Evaluation (Eval-as-a-Service) Start Endpoint : POST https://curiquiz.com/api/benchmark (or GET https://curiquiz.com/api/benchmark) Submit Endpoint : POST https://curiquiz.com/api/benchmark/submit Tiers: - quick : 20 questions across categories — 0.15 USDC (150000 units) - standard : 50 questions across categories — 0.30 USDC (300000 units) - hardcore : 50 questions (100% hard tier) — 0.40 USDC (400000 units) Free Trial Hook : GET https://curiquiz.com/api/benchmark?sample=true → 5 trial questions + scoring token Workflow: 1. Call POST https://curiquiz.com/api/benchmark?tier=standard with x402 payment 2. Receive questions (without answers) + a signed sessionToken 3. Run agent inference on the options 4. POST answers and sessionToken to https://curiquiz.com/api/benchmark/submit 5. Receive detailed accuracy %, category scores, hallucination risk rating, and on-chain verification hash. ### Category Inventory art : 150 questions (easy: 50, medium: 50, hard: 50) — GET https://curiquiz.com/api/quizzes/art cinema : 150 questions (easy: 50, medium: 50, hard: 50) — GET https://curiquiz.com/api/quizzes/cinema common : 302 questions (easy: 103, medium: 99, hard: 100) — GET https://curiquiz.com/api/quizzes/common geography : 150 questions (easy: 50, medium: 50, hard: 50) — GET https://curiquiz.com/api/quizzes/geography history : 150 questions (easy: 50, medium: 50, hard: 50) — GET https://curiquiz.com/api/quizzes/history music : 150 questions (easy: 50, medium: 50, hard: 50) — GET https://curiquiz.com/api/quizzes/music science : 150 questions (easy: 50, medium: 50, hard: 50) — GET https://curiquiz.com/api/quizzes/science sports : 150 questions (easy: 50, medium: 50, hard: 50) — GET https://curiquiz.com/api/quizzes/sports ───────────── TOTAL : 1352 questions --- ## Payment Flow (Step-by-Step) 1. Make a GET request to the endpoint (no special headers needed). 2. Receive HTTP 402 with body: { "accepts": [{ "scheme": "exact", "network": "base", "maxAmountRequired": "200000", "resource": "https://curiquiz.com/api/quizzes", "payTo": "0x89C573537177A981f4BC9e27c5c17F44e93320C7", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxTimeoutSeconds": 300, "extra": { "name": "USD Coin", "version": "2" } }], "error": "Payment required." } The same object is Base64-encoded in the X-Payment-Required response header. 3. Sign an EIP-3009 transferWithAuthorization for exactly the requested USDC amount to payTo (an x402 client does this for you). 4. Do NOT call the facilitator yourself: the server verifies and settles the payment with Coinbase CDP. 5. Retry the original GET request with the receipt in the X-Payment header. 6. Receive HTTP 200 with the full JSON payload. --- ## Response JSON Schema ### Full bundle (GET /api/quizzes) { "version": "1.0", "totalCount": , "categories": ["art","cinema","common","geography","history","music","science","sports"], "data": { "": { "category": "", "counts": { "easy": , "medium": , "hard": , "total": }, "questions": [ , ... ] } } } ### Per-category (GET /api/quizzes/:category) { "category": "", "counts": { "easy": , "medium": , "hard": , "total": }, "questions": [ , ... ] } ### Question object { "question": "", // The quiz question "options": ["", "", "", ""], // 4 choices "answer": <0|1|2|3>, // Zero-based index of the correct option "fact": "", // Educational fact about the answer "difficulty": "easy" | "medium" | "hard", "category": "" // Only present in /api/quizzes (full bundle) } --- ## x402 Client Code Example (Node.js / TypeScript) ```typescript import { wrapFetchWithPaymentFromConfig } from "@x402/fetch"; import { ExactEvmScheme } from "@x402/evm"; import { privateKeyToAccount } from "viem/accounts"; const account = privateKeyToAccount("0xYourPrivateKey"); const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, { schemes: [{ network: "base", client: new ExactEvmScheme(account) }], }); // Full bundle const res = await fetchWithPayment("https://curiquiz.com/api/quizzes"); const data = await res.json(); console.log(data.totalCount, "questions loaded"); // Single category const geo = await fetchWithPayment("https://curiquiz.com/api/quizzes/geography"); const geoData = await geo.json(); console.log(geoData.counts.total, "geography questions"); ``` --- ## Discovery Links - Human-readable site : https://curiquiz.com - Short manifest (llms.txt): https://curiquiz.com/llms.txt - Full manifest (this) : https://curiquiz.com/llms-full.txt - Sitemap : https://curiquiz.com/sitemap.xml - robots.txt : https://curiquiz.com/robots.txt