Hello

Read the about page.

$\"logo\"$ ',\n baseUrl: \"https://example.com\",\n },\n },\n output: {\n example: {\n service: \"ox-alpha-service\",\n endpoint: \"html-clean\",\n title: \"Example Domain\",\n description: \"An illustrative page\",\n lang: \"en\",\n canonical: \"https://example.com/\",\n wordCount: 8,\n text: \"Hello\\n\\nRead the about page.\",\n truncated: false,\n headings: [{ level: 1, text: \"Hello\" }],\n links: [{ url: \"https://example.com/about\", text: \"about page\" }],\n images: [{ url: \"https://example.com/logo.png\", alt: \"logo\" }],\n },\n },\n }),\n },\n },\n resourceServer,\n undefined,\n undefined,\n false,\n ),\n);\n\napp.get(\"/health\", (c) =>\n c.json({\n ok: true,\n service: \"ox-alpha-service\",\n version: VERSION,\n endpoints: [\"GET /\", \"GET /html-clean\", \"POST /html-clean\", \"GET /stats\", \"GET /docs\", \"GET /openapi.json\"],\n networks: NETWORKS,\n ts: Date.now(),\n facilitator: FACILITATOR_URL,\n }),\n);\n\napp.get(\"/stats\", async (c) => {\n const blob = await getBlob();\n if (!blob) {\n return c.json({ service: \"ox-alpha-service\", stats: null, note: \"telemetry unavailable\" });\n }\n try {\n const raw = await safeGetJSON(blob, STATS_KEY);\n const stats = (raw && typeof raw === \"object\") ? raw : {};\n return c.json({\n service: \"ox-alpha-service\",\n version: VERSION,\n note: \"hits per UTC day; key = METHOD routeClass outcome (probe402 = unpaid 402 response, ok = served, err = >=400)\",\n stats,\n });\n } catch {\n return c.json({ service: \"ox-alpha-service\", stats: null, note: \"telemetry read error\" });\n }\n});\n\napp.get(\"/\", (c) =>\n c.json({\n service: \"ox-alpha-service\",\n version: VERSION,\n networks: NETWORKS,\n paid: true,\n ts: Date.now(),\n }),\n);\n\napp.get(\"/html-clean\", (c) =>\n c.json({\n service: \"ox-alpha-service\",\n endpoint: \"html-clean\",\n usage: {\n method: \"POST\",\n path: \"/html-clean\",\n contentType: \"application/json\",\n bodySchema: {\n html: \"string (required): raw HTML source, max 1MB\",\n baseUrl: \"string (optional): base URL to resolve relative links/images\",\n },\n returns: [\"title\", \"description\", \"lang\", \"canonical\", \"ogImage\", \"wordCount\", \"text\", \"truncated\", \"headings\", \"links\", \"images\"],\n exampleCall: {\n html: \"

Hi

Read the about page.

\",\n baseUrl: \"https://example.com\",\n },\n },\n version: VERSION,\n }),\n);\n\napp.post(\"/html-clean\", async (c) => {\n let body: unknown;\n try {\n body = await c.req.json();\n } catch {\n return c.json({ error: \"request body must be valid JSON\" }, 400);\n }\n const b = (body ?? {}) as Record;\n const html = typeof b.html === \"string\" ? b.html : null;\n if (!html || !html.trim()) {\n return c.json({ error: \"missing required field: html (non-empty string)\" }, 400);\n }\n if (html.length > MAX_HTML_CHARS) {\n return c.json({ error: `html too large: ${html.length} chars, max ${MAX_HTML_CHARS}` }, 413);\n }\n const baseUrl =\n typeof b.baseUrl === \"string\" && b.baseUrl.trim() ? b.baseUrl.trim() : undefined;\n\n const root = parse(html);\n root.querySelectorAll(\"script,style,noscript,template,svg,iframe\").forEach((el) => {\n const remove = (el as unknown as { remove?: () => void }).remove;\n if (typeof remove === \"function\") remove.call(el);\n });\n\n const metaTag = (selector: string): string => {\n const el = root.querySelector(selector);\n return oneLine(el?.getAttribute(\"content\"));\n };\n\n const htmlLang = oneLine(root.querySelector(\"html\")?.getAttribute(\"lang\")) || undefined;\n\n const title = oneLine(root.querySelector(\"title\")?.text) || metaTag('meta[property=\"og:title\"]') || \"\";\n const description = metaTag('meta[name=\"description\"]') || metaTag('meta[property=\"og:description\"]') || \"\";\n const canonicalRaw = root.querySelector('link[rel=\"canonical\"]')?.getAttribute(\"href\");\n const canonical = resolveUrl(canonicalRaw, baseUrl ?? undefined) ?? undefined;\n const ogImage = resolveUrl(metaTag('meta[property=\"og:image\"]'), baseUrl) ?? undefined;\n\n const contentEl =\n root.querySelector(\"article\") ??\n root.querySelector(\"main\") ??\n root.querySelector('[role=\"main\"]') ??\n root.querySelector(\"body\") ??\n root;\n\n const fullText = normalizeBlocks(extractStructuredText(contentEl));\n const truncated = fullText.length > MAX_TEXT_CHARS;\n const text = truncated ? `${fullText.slice(0, MAX_TEXT_CHARS)}…` : fullText;\n const wordCount = text.split(/\\s+/).filter(Boolean).length;\n\n const headings = root\n .querySelectorAll(\"h1,h2,h3,h4,h5,h6\")\n .map((el) => ({ level: Number(el.tagName.slice(1)) || 0, text: oneLine(el.text) }))\n .filter((h) => h.text.length > 0)\n .slice(0, 100);\n\n const seenLinks = new Set();\n const links: Array<{ url: string; text: string }> = [];\n for (const a of root.querySelectorAll(\"a[href]\")) {\n const abs = resolveUrl(a.getAttribute(\"href\"), baseUrl ?? undefined);\n if (!abs || seenLinks.has(abs)) continue;\n seenLinks.add(abs);\n links.push({ url: abs, text: oneLine(a.text) });\n if (links.length >= MAX_LINKS) break;\n }\n\n const seenImgs = new Set();\n const images: Array<{ url: string; alt: string }> = [];\n for (const img of root.querySelectorAll(\"img[src]\")) {\n const abs = resolveUrl(img.getAttribute(\"src\"), baseUrl ?? undefined);\n if (!abs || seenImgs.has(abs)) continue;\n seenImgs.add(abs);\n images.push({ url: abs, alt: oneLine(img.getAttribute(\"alt\")) });\n if (images.length >= MAX_IMAGES) break;\n }\n\n return c.json({\n service: \"ox-alpha-service\",\n endpoint: \"html-clean\",\n title: title || undefined,\n description: description || undefined,\n lang: htmlLang,\n canonical,\n ogImage,\n wordCount,\n text,\n truncated,\n headings,\n links,\n images,\n });\n});\n\napp.get(\"/openapi.json\", (c) =>\n c.json({\n openapi: \"3.1.0\",\n info: {\n title: \"ox-alpha-service\",\n version: VERSION,\n description:\n \"Paid micro-APIs for AI agents, native x402 protocol (USDC over HTTP 402). Unauthenticated calls receive HTTP 402 with payment requirements; a compliant client signs an EIP-3009 authorization, the facilitator settles on-chain and the retried call includes the X-PAYMENT header. Settles on Base mainnet (eip155:8453, real USDC) and Base Sepolia (eip155:84532) via https://facilitator.payai.network.\",\n },\n servers: [{ url: \"https://oxalpha-x402.val.run\" }],\n \"x-payment\": {\n protocol: \"x402\",\n version: 2,\n scheme: \"exact\",\n networks: NETWORKS,\n asset: \"USDC\",\n facilitator: FACILITATOR_URL,\n },\n paths: {\n \"/\": {\n get: {\n summary: \"Paid ping\",\n description: \"Returns service status, version and timestamp. Price $0.001 USDC.\",\n responses: {\n \"200\": { description: \"Ping result\", content: { \"application/json\": { schema: { type: \"object\" } } } },\n \"402\": { description: \"Payment required (x402)\" },\n },\n },\n },\n \"/html-clean\": {\n get: {\n summary: \"Usage info for html-clean\",\n description:\n \"Machine-readable instructions for POST /html-clean. Price $0.002 USDC.\",\n responses: {\n \"200\": { description: \"Usage info\", content: { \"application/json\": { schema: { type: \"object\" } } } },\n \"402\": { description: \"Payment required (x402)\" },\n },\n },\n post: {\n summary: \"Clean raw HTML into LLM-ready structured content\",\n description:\n \"Turns raw HTML into title, meta description, canonical URL, lang, ogImage, word count, paragraph-preserving plain text, heading outline and deduplicated links/images with absolute URLs. Price $0.002 USDC.\",\n requestBody: {\n required: true,\n content: {\n \"application/json\": {\n schema: {\n type: \"object\",\n required: [\"html\"],\n properties: {\n html: { type: \"string\", description: \"Raw HTML source, max 1MB\" },\n baseUrl: { type: \"string\", description: \"Optional base URL to resolve relative links/images\" },\n },\n },\n },\n },\n },\n responses: {\n \"200\": { description: \"Structured content\", content: { \"application/json\": { schema: { type: \"object\" } } } },\n \"400\": { description: \"Invalid body\" },\n \"402\": { description: \"Payment required (x402)\" },\n \"413\": { description: \"HTML too large\" },\n },\n },\n },\n \"/health\": {\n get: {\n summary: \"Service health\",\n description: \"Free. Returns ok flag, version, endpoint list and facilitator in use.\",\n responses: { \"200\": { description: \"Health status\" } },\n },\n },\n \"/stats\": {\n get: {\n summary: \"Hit counters\",\n description: \"Free. Per-UTC-day request counters by method, route class and outcome.\",\n responses: { \"200\": { description: \"Stats\" } },\n },\n },\n \"/docs\": {\n get: {\n summary: \"Human-readable documentation\",\n description: \"Free. HTML landing page describing the service and its paid endpoints.\",\n responses: { \"200\": { description: \"HTML page\" } },\n },\n },\n },\n }),\n);\n\napp.get(\"/docs\", (c) =>\n c.html(`\n\n\n\n\nox-alpha-service — paid micro-APIs for AI agents\n\n\n\n

ox-alpha-service

Paid micro-APIs for AI agents — x402 native (HTTP 402 + USDC)

\n\n

This service exposes small, useful HTTP endpoints that charge per call with\nx402: no accounts, no API keys, no subscriptions.\nAn unauthenticated request gets 402 Payment Required; an x402-aware client\nsigns a payment authorization, a facilitator settles it on-chain in USDC, and the call succeeds.

\n\n

Endpoints

\n\n\n\n\n\n\n\n\n

Method	Path	Price	What you get
GET	`/`	$0.001	Signed ping: service id, version, timestamp
GET	`/html-clean`	$0.002	Usage doc for the tool below
POST	`/html-clean`	$0.002	Raw HTML → clean structured content (title, meta, LLM-ready text, outline, links, images)
GET	`/health`	free	Liveness + config
GET	`/stats`	free	Public hit counters
GET	`/openapi.json`	free	Machine-readable spec

\n\n

Try it

curl -i https://oxalpha-x402.val.run/\n# HTTP/1.1 402 Payment Required\n# payment-required: base64(JSON with amount, payTo, network...)\n\n# with any x402 client, e.g. @x402/fetch (TypeScript):\nimport { wrapFetchWithPayment } from \"@x402/fetch\";\nconst fetchWithPay = await wrapFetchWithPayment(fetch, account);\nconst res = await fetchWithPay(\"https://oxalpha-x402.val.run/\");

\n\n

The POST /html-clean body is JSON:\n{\"html\":\"<raw html>\",\"baseUrl\":\"https://example.com\"}.\nResponse includes text (paragraph-preserving, max 60k chars), plus\ntitle, description, lang, canonical,\nogImage, wordCount, headings, deduplicated\nlinks and images.

\n\n

Status

Version ${VERSION} · live since Aug 2026
Settlement: USDC on Base mainnet (eip155:8453, real USDC) and Base Sepolia testnet (eip155:84532) via facilitator facilitator.payai.network. Pay either network — both options are listed in every 402 response.
Listed in the PayAI x402 discovery catalog; validated against the Coinbase CDP validator.

\n\n\n\n`),\n);\n\nexport default {\n fetch: app.fetch,\n};\n",["D",1787514967101],"branchVersion","label",[18],"pulls","branches","forks","envVars",{"_286":26,"_288":26},"connections",{"_286":26,"_287":26},"count","unfilledCount","emptyCount",{"_47":272,"_13":18,"_75":76,"_57":-5,"_49":50,"_276":194,"_293":214,"_51":301,"_53":122,"_77":21,"_273":274,"_78":24,"_277":-5,"_298":302,"_17":303},{"_47":291,"_13":292,"_75":212,"_57":-5,"_49":50,"_276":237,"_293":214,"_51":294,"_53":130,"_77":295,"_273":296,"_78":24,"_277":297,"_298":299,"_17":300},"cb194881-33db-4dc4-9133-600d6913e3a7","new-file-1580.ts","latest",["D",1787514967403],"http","/* Open in Val Town: https://www.val.town/x/oxalpha/x402/code/new-file-1580.ts */\nimport mod from \"https://esm.town/v/oxalpha/x402/main.tsx?v=20\";\nconst handler = mod && typeof mod === \"object\" && \"fetch\" in mod\n ? mod.fetch.bind(mod)\n : mod;\nexport default async function (req) {\n return handler(req);\n}\n","oxalpha-x402","children",[],[292],["D",1787514967101],[],[18],["D",1787507519355],{"_11":12,"_250":81},{"_11":12,"_246":81,"_80":81,"_30":79,"_247":248,"_249":24},{"_53":237,"_13":16,"_47":50,"_238":201,"_239":-5,"_240":-5,"_241":-5,"_242":-5,"_243":-5,"_244":14,"_245":12},"ctx",{"_65":-5,"_269":341,"_342":343,"_344":345,"_346":24,"_347":24,"_348":24,"_349":214,"_350":-5,"_351":-7,"_352":-7,"_353":26,"_354":24,"_355":24,"_356":-5,"_357":24,"_358":24,"_359":24,"_360":-5},"ENV",{"_312":313,"_314":315,"_316":16,"_317":318,"_319":320,"_321":322,"_323":324,"_325":326,"_327":328,"_329":330,"_331":332,"_333":334,"_335":336,"_337":338,"_339":340},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

History · main.tsx