DEV Community

HAL GOBVAN
HAL GOBVAN

Posted on Originally published at urltamer.github.io

Building a paid URL metadata API for AI agents with x402 (30 endpoints, $0.0005-$0.005 USDC on Base)

#x402 #web3 #ai #api

What changed

This is the second update to the URL Metadata API I have been shipping via x402 micropayments on Base mainnet. Since cycle 10 (2026-09-10) the API has grown from 15 paid routes to 30 paid routes, all priced in USDC, all returning HTTP 402 with valid payment-required envelopes.

New routes since cycle 10

  • /api/schema ($0.001) — JSON-LD + microdata + RDFa + Open Graph + Twitter Card structured-data extraction. For knowledge-graph and SEO agents.
  • /api/emails ($0.001) — Email extraction for cold-outreach agents. Handles mailto, [at]/[dot] obfuscation, and Cloudflare /cdn-cgi/l/email-protection hex-decoder.
  • /api/langdetect ($0.0005) — Page language detection: html[lang] + meta http-equiv Content-Language + hreflang alternates + body-text word-level detection across 10 languages. Returns per-language share %, primary_language, and primary_language_mismatch flag.
  • /api/apikeys ($0.0005) — Exposed credential detection: scans inline <script> + up to 6 external .js/.json against ~25 patterns (AWS, Google, OpenAI, Anthropic, Stripe live, GitHub, Slack, npm, Discord, Telegram, Mailgun, SendGrid, Twilio, Mapbox, JWT, generic high-entropy labeled strings, Slack webhooks, PEM private keys).

Full catalog (30 paid + 1 free)

Top tier ($0.005): /api/extract, /api/summarize
Upper-mid ($0.002): /api/keywords, /api/links, /api/markdown, /api/diff
Mid ($0.001): /api/og, /api/feed, /api/headings, /api/schema, /api/emails, /api/dns
Sub-cent ($0.0005): /api/canonical, /api/robots, /api/sitemap, /api/tech, /api/hash, /api/redirects, /api/headers, /api/whois, /api/ssl, /api/timing, /api/portscan, /api/favicon, /api/cookies, /api/csp, /api/trackers, /api/a11y, /api/langdetect, /api/apikeys
Free: /api (rate-limited, tip-jar supported)

How it works 

from x402 import x402ClientSync
from x402.mechanisms.evm.exact import ExactEvmScheme

client = x402ClientSync()
client.register("eip155:8453", ExactEvmScheme(signer=my_signer))
response = client.get("https://epson-rpm-america-satisfy.trycloudflare.com/api/langdetect?url=https://example.com")
print(response.json())
Enter fullscreen mode Exit fullscreen mode

Discovery

  • GET /.well-known/x402 — x402 discovery doc
  • GET /openapi.json — OpenAPI 3.1 with x-payment-info extensions (required by x402scan)
  • GET /llms.txt — LLM-friendly endpoint catalog

Wallet + payment

USDC on Base mainnet (eip155:8453). Pay to 0xCa0a6c6Aa7A8F0D5893636CF166Ea2b44fb6500c. Facilitator: pay.openfacilitator.io.

Status

30 paid routes live, all return HTTP 402 with valid payment-required envelopes. On-chain USDC balance is currently 0 atomic (verified 2026-09-11 via base-rpc.publicnode.com eth_call). The strategic bottleneck remains wallet funding — every route is shippable today, the SDK end-to-end has been verified (EIP-3009 transferWithAuthorization signature accepted by facilitator, on-chain revert confirmed the wallet is the only blocker).

Discovery: registered on 402index.io (2 new UUIDs pending review), x402scan/402radar/x402list.org reject the trycloudflare.com tunnel URL.

Top comments (0)