Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
docs(x402): document the 8 keyless live-data services and publish the changelog entry
nirholase18987975cfc
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex e77ec9c16..90d0a6c36 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,6 +6,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr## 2026-10-14+- **8 keyless live-data services join the x402 paid API: weather, grid carbon, domains, research, books, news, transit, places**: three.ws's x402 surface grows 17 new routes, each needing no API key anywhere in the chain (not an upstream key, not a three.ws key), ported natively onto three.ws's own Solana facilitator so they settle, receipt, and discover exactly like every other paid endpoint: Weather Guard (24h forecast + severe alerts from Open-Meteo, NWS fallback), Carbon (UK grid carbon intensity + lowest-carbon scheduling window), Domains (live RDAP registration lookups, single and bulk), Research (paper search across arXiv/Crossref/Semantic Scholar, metadata, bibliographies), Books (OpenLibrary + Project Gutenberg search and full-text reads), News Wire (global news search and polling over GDELT DOC 2.0), Transit (MBTA GTFS trip planning and realtime delay snapshots), and Places (OpenStreetMap Overpass point-of-interest search and detail). Each service's discovery route runs a free daily per-IP quota before falling through to the x402 pay-per-call lane, fails closed to the paid rail rather than opening an unmetered proxy if the quota store is unreachable, and every upstream call sends an identifying User-Agent. No fixture or mocked fallback anywhere in the set: an upstream outage answers 502, and the one route whose source suite offers a fake-data fallback when unconfigured (Places Detail's review enrichment) ships without that fallback, returning only the real OpenStreetMap record. All 17 routes appear in GET /openapi.json and GET /.well-known/x402.json with Solana listed first in every payment challenge. (`/docs/x402-endpoints`) `[feature]`- **A new wallet linkage score flags a coin's creator buying their own launch**: GET /api/crypto/linkage cross-checks 2-10 Solana addresses for shared control: a 0-100 same-controller score per pair, combining six real on-chain signals by noisy-OR (shared fee payer, one address funding the other, both sharing a first funder, SPL token-account control, direct transfers, a shared funder sending similar amounts in a short window), every match backed by the signature or account that triggered it. It is keyless, free, and part of the public Crypto Data API, and now wired into two places that act on money: the Trade Safety Firewall warns when an early buyer scores as the same controller as a coin's creator (wash-trading dressed up as demand), and copy-trading refuses to size an order behind a leader whose own wallet links to the creator of the coin they are 'signaling', showing the follower exactly why. The same scorer ships as the wallet_linkage tool in the hosted intel MCP server for any AI agent to call directly. (`/crypto-api`) `[feature, security]`- **A read-only drift report for every standalone GitHub mirror**: npm run mirrors:drift compares each of the ~105 standalone mirrors in data/standalone-mirrors.json against its monorepo source at the last synced commit (GitHub API, with a README-timestamp fallback when rate-limited), flags any package whose GitHub copy has diverged, and writes the result to tasks/mirror-drift-<date>.json. It never pushes or mutates a mirror; it is the audit step that found the two fixes above. (`/docs/contributing`) `[infra, docs]`- **Agents can now carry an owner-signed, offline-verifiable spend cap**: A new Delegation tab in the agent wallet hub lets an owner sign a portable spend delegation with their own linked Solana wallet (a message, never a transaction): 'this agent may move at most CAP lamports per EPOCH, until NOT_AFTER.' The signed envelope is plain text and the verification math is a zero-dependency function any outside counterparty can run themselves (packages/agent-guards, spec in its README) to confirm the authorization without trusting three.ws's say-so. three.ws enforces the same cap server-side on every call through POST /api/agent/guard, measured from the agent wallet's REALIZED spend in the custody ledger rather than the agent's own claim, so an exact-output trade that ends up costing more than advertised still can't slip past the ceiling. A replayed nonce, an expired delegation, or a signature from the wrong wallet is rejected with a specific reason. (`/docs/agent-wallet-api`) `[feature, security]`diff --git a/data/changelog.json b/data/changelog.jsonindex 565ccb418..9c05bba4e 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,15 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security, desktop (desktop entries become the desktop app's release notes). `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-10-14",+ "title": "8 keyless live-data services join the x402 paid API: weather, grid carbon, domains, research, books, news, transit, places",+ "summary": "three.ws's x402 surface grows 17 new routes, each needing no API key anywhere in the chain (not an upstream key, not a three.ws key), ported natively onto three.ws's own Solana facilitator so they settle, receipt, and discover exactly like every other paid endpoint: Weather Guard (24h forecast + severe alerts from Open-Meteo, NWS fallback), Carbon (UK grid carbon intensity + lowest-carbon scheduling window), Domains (live RDAP registration lookups, single and bulk), Research (paper search across arXiv/Crossref/Semantic Scholar, metadata, bibliographies), Books (OpenLibrary + Project Gutenberg search and full-text reads), News Wire (global news search and polling over GDELT DOC 2.0), Transit (MBTA GTFS trip planning and realtime delay snapshots), and Places (OpenStreetMap Overpass point-of-interest search and detail). Each service's discovery route runs a free daily per-IP quota before falling through to the x402 pay-per-call lane, fails closed to the paid rail rather than opening an unmetered proxy if the quota store is unreachable, and every upstream call sends an identifying User-Agent. No fixture or mocked fallback anywhere in the set: an upstream outage answers 502, and the one route whose source suite offers a fake-data fallback when unconfigured (Places Detail's review enrichment) ships without that fallback, returning only the real OpenStreetMap record. All 17 routes appear in GET /openapi.json and GET /.well-known/x402.json with Solana listed first in every payment challenge.",+ "tags": [+ "feature"+ ],+ "link": "/docs/x402-endpoints"+ },{"date": "2026-10-14","title": "Agents can now carry an owner-signed, offline-verifiable spend cap",diff --git a/docs/x402-endpoints.md b/docs/x402-endpoints.mdindex ab165a476..a46a7e78f 100644--- a/docs/x402-endpoints.md+++ b/docs/x402-endpoints.md@@ -307,6 +307,36 @@ directory.| `/api/x402/verify-receipt` | free | Recomputes a paid response's SHA-256 attestation and confirms a settlement tx on-chain. See [x402 dev tools](x402-dev-tools.md). || `/api/x402/inference-verify` | free | Audits a metered-inference receipt from a paid `llm-proxy` call: per-check verdicts for the issuer signature, the node's response signature, prompt/response hash re-derivation from raw text, on-chain settlement confirmation, and whether the issuer matches the platform's published signers. See [Run an inference node](inference-node-operator.md). |+## Live public-data endpoints (the keyless x402-suite ports)++Eight endpoints ported from the owner's `x402-suite` that need no API key+anywhere in the chain: no upstream key, no three.ws key. Each has a free+daily per-IP quota ahead of the paid x402 lane (fails closed to the paid rail+on a Redis outage, never opens an unmetered proxy), and every upstream call+sends a polite identifying User-Agent. Each also has a secondary, always-paid+route that never runs a free lane. Upstream outages surface as `502`, never a+fabricated or cached-as-live result.++| Endpoint | Default | Free quota (per IP/day) | Returns |+| --------------------------------- | ------- | ------------------------ | --------------------------------------------------------------------------------------------- |+| `/api/x402/weather-guard-forecast` | $0.001 | 20 | 24h hourly forecast + active severe-weather alerts for any lat/lon, live from Open-Meteo with a US National Weather Service fallback. |+| `/api/x402/weather-guard-decision` | $0.002 | always paid | Go/no-go weather decision for an outdoor plan window, reasoned over the same forecast. |+| `/api/x402/carbon-now` | $0.001 | 20 | Current UK grid carbon intensity (actual + forecast, generation mix by fuel). |+| `/api/x402/carbon-best-window` | $0.002 | always paid | Lowest-carbon window to run a flexible load in the next 48h, from the UK Carbon Intensity forecast. |+| `/api/x402/domains-check` | $0.001 | 15 | Live domain registration status, registrar, dates and nameservers via RDAP. |+| `/api/x402/domains-bulk` | $0.003 | always paid | RDAP lookup across up to 20 domains in one call. |+| `/api/x402/research-search` | $0.002 | 10 | Academic paper search across arXiv, Crossref and Semantic Scholar. |+| `/api/x402/research-paper` | $0.003 | always paid | Full metadata + abstract for one paper by DOI or arXiv id. |+| `/api/x402/research-bibliography` | $0.005 | always paid | Formatted bibliography (APA/MLA/BibTeX) for a list of papers. |+| `/api/x402/books-search` | $0.001 | 10 | Book search across OpenLibrary and Project Gutenberg, with cover art and ebook access. |+| `/api/x402/books-read` | $0.002 | always paid | Full public-domain text (Gutenberg) or borrow/preview link for one edition. |+| `/api/x402/news-wire-query` | $0.003 | 5 | Global news search over the last 15 minutes to 3 months via GDELT DOC 2.0, with a volume timeline. |+| `/api/x402/news-wire-pulse` | $0.002 | always paid | New articles for a saved query since a cursor, for agents polling without re-fetching. GDELT throttles this shared IP to ~1 request/5s; calls are serialized and retried, never hammered. |+| `/api/x402/transit-plan` | $0.002 | 20 | Direct + one-transfer trip itineraries between two MBTA stops/stations/coordinates, with realtime prediction overlay. |+| `/api/x402/transit-delays` | $0.001 | always paid | Realtime vs scheduled delay snapshot for a stop, with a per-arrival breakdown and verdict. |+| `/api/x402/places-search` | $0.002 | 15 | Points of interest near a coordinate from OpenStreetMap (Overpass), optionally filtered by category. |+| `/api/x402/places-detail` | $0.002 | always paid | Full live OpenStreetMap record for one place by id. No fixture fallback: a place with no third-party review enrichment configured returns only the real OSM record, never an invented review. |+## $THREE onlyAny endpoint that references a coin references **$THREE**diff --git a/public/changelog-recent.json b/public/changelog-recent.jsonindex 092718c46..5d481a9ac 100644--- a/public/changelog-recent.json+++ b/public/changelog-recent.json@@ -1,14 +1,24 @@{- "generated_at": "2026-10-14T22:09:58.191Z",+ "generated_at": "2026-10-14T23:21:31.804Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},- "total": 4094,+ "total": 4095,"complete": false,"full_feed": "/changelog.json","entries": [+ {+ "date": "2026-10-14",+ "type": "update",+ "title": "8 keyless live-data services join the x402 paid API: weather, grid carbon, domains, research, books, news, transit, places",+ "summary": "three.ws's x402 surface grows 17 new routes, each needing no API key anywhere in the chain (not an upstream key, not a three.ws key), ported natively onto three.ws's own Solana facilitator so they settle, receipt, and discover exactly like every other paid endpoint: Weather Guard (24h forecast + severe alerts from Open-Meteo, NWS fallback), Carbon (UK grid carbon intensity + lowest-carbon scheduling window), Domains (live RDAP registration lookups, single and bulk), Research (paper search across arXiv/Crossref/Semantic Scholar, metadata, bibliographies), Books (OpenLibrary + Project Gutenberg search and full-text reads), News Wire (global news search and polling over GDELT DOC 2.0), Transit (MBTA GTFS trip planning and realtime delay snapshots), and Places (OpenStreetMap Overpass point-of-interest search and detail). Each service's discovery route runs a free daily per-IP quota before falling through to the x402 pay-per-call lane, fails closed to the paid rail rather than opening an unmetered proxy if the quota store is unreachable, and every upstream call sends an identifying User-Agent. No fixture or mocked fallback anywhere in the set: an upstream outage answers 502, and the one route whose source suite offers a fake-data fallback when unconfigured (Places Detail's review enrichment) ships without that fallback, returning only the real OpenStreetMap record. All 17 routes appear in GET /openapi.json and GET /.well-known/x402.json with Solana listed first in every payment challenge.",+ "link": "/docs/x402-endpoints",+ "tags": [+ "feature"+ ]+ },{"date": "2026-10-14","type": "update",@@ -1546,16 +1556,6 @@"tags": ["feature"]- },- {- "date": "2026-10-10",- "type": "update",- "title": "Agents can now send invoices, sell things, buy from each other and ask for higher limits",- "summary": "Your agent can bill anyone in USDC, SOL or $THREE. Each invoice gets a share page, a Solana Pay link and a QR code that any Solana wallet can scan, and three.ws watches the chain to mark it paid, part-paid or expired on its own, with notifications, webhooks and a receipt. Paid invoices show up in your agent's earnings next to skill sales and creator fees. Agents can also list things for sale and buy from each other with a quote first and an explicit confirm, and the goods are only released once the payment is verified. Sending money takes a preview and a confirm, and goes to your approvals unless the address is on your allowlist. An agent can read its own spending limits and propose changes, but only you can approve them, after confirming it is you. Manage it all on the new Commerce page.",- "link": "/commerce",- "tags": [- "feature"- ]}]}diff --git a/public/changelog.json b/public/changelog.jsonindex 2e646a904..f7c5ad85d 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,11 +1,21 @@{- "generated_at": "2026-10-14T22:09:58.170Z",+ "generated_at": "2026-10-14T23:21:31.782Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},"entries": [+ {+ "date": "2026-10-14",+ "type": "update",+ "title": "8 keyless live-data services join the x402 paid API: weather, grid carbon, domains, research, books, news, transit, places",+ "summary": "three.ws's x402 surface grows 17 new routes, each needing no API key anywhere in the chain (not an upstream key, not a three.ws key), ported natively onto three.ws's own Solana facilitator so they settle, receipt, and discover exactly like every other paid endpoint: Weather Guard (24h forecast + severe alerts from Open-Meteo, NWS fallback), Carbon (UK grid carbon intensity + lowest-carbon scheduling window), Domains (live RDAP registration lookups, single and bulk), Research (paper search across arXiv/Crossref/Semantic Scholar, metadata, bibliographies), Books (OpenLibrary + Project Gutenberg search and full-text reads), News Wire (global news search and polling over GDELT DOC 2.0), Transit (MBTA GTFS trip planning and realtime delay snapshots), and Places (OpenStreetMap Overpass point-of-interest search and detail). Each service's discovery route runs a free daily per-IP quota before falling through to the x402 pay-per-call lane, fails closed to the paid rail rather than opening an unmetered proxy if the quota store is unreachable, and every upstream call sends an identifying User-Agent. No fixture or mocked fallback anywhere in the set: an upstream outage answers 502, and the one route whose source suite offers a fake-data fallback when unconfigured (Places Detail's review enrichment) ships without that fallback, returning only the real OpenStreetMap record. All 17 routes appear in GET /openapi.json and GET /.well-known/x402.json with Solana listed first in every payment challenge.",+ "link": "/docs/x402-endpoints",+ "tags": [+ "feature"+ ]+ },{"date": "2026-10-14","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex e1e146b39..3a4fd0f09 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -6,6 +6,14 @@<atom:link href="https://three.ws/changelog.xml" rel="self" type="application/rss+xml"/><description>What's new on three.ws: features, improvements, and releases, newest first.</description><language>en</language>+ <item>+ <title>8 keyless live-data services join the x402 paid API: weather, grid carbon, domains, research, books, news, transit, places</title>+ <link>https://three.ws/docs/x402-endpoints</link>+ <guid isPermaLink="false">2026-10-14:8 keyless live-data services join the x402 paid API: weather, grid carbon, domains, research, books, news, transit, places</guid>+ <pubDate>Wed, 14 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>three.ws's x402 surface grows 17 new routes, each needing no API key anywhere in the chain (not an upstream key, not a three.ws key), ported natively onto three.ws's own Solana facilitator so they settle, receipt, and discover exactly like every other paid endpoint: Weather Guard (24h forecast + severe alerts from Open-Meteo, NWS fallback), Carbon (UK grid carbon intensity + lowest-carbon scheduling window), Domains (live RDAP registration lookups, single and bulk), Research (paper search across arXiv/Crossref/Semantic Scholar, metadata, bibliographies), Books (OpenLibrary + Project Gutenberg search and full-text reads), News Wire (global news search and polling over GDELT DOC 2.0), Transit (MBTA GTFS trip planning and realtime delay snapshots), and Places (OpenStreetMap Overpass point-of-interest search and detail). Each service's discovery route runs a free daily per-IP quota before falling through to the x402 pay-per-call lane, fails closed to the paid rail rather than opening an unmetered proxy if the quota store is unreachable, and every upstream call sends an identifying User-Agent. No fixture or mocked fallback anywhere in the set: an upstream outage answers 502, and the one route whose source suite offers a fake-data fallback when unconfigured (Places Detail's review enrichment) ships without that fallback, returning only the real OpenStreetMap record. All 17 routes appear in GET /openapi.json and GET /.well-known/x402.json with Solana listed first in every payment challenge.</description>+ </item><item><title>A new wallet linkage score flags a coin's creator buying their own launch</title><link>https://three.ws/crypto-api</link>diff --git a/public/features.json b/public/features.jsonindex 809d21390..d5a66e919 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-10-14T22:09:58.157Z",+ "generated_at": "2026-10-14T23:21:31.769Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",