Skip to content

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.

docs(trader-card): register the embed doc across the site index

nirholasfe4a6fb3f53c
diff --git a/STRUCTURE.md b/STRUCTURE.md
index f09d03d2b..8b064d918 100644
--- a/STRUCTURE.md
+++ b/STRUCTURE.md
@@ -285,6 +285,7 @@ bottom.
| Ghost-copy (paper-copy a leader) | [pages/ghost-copy.html](pages/ghost-copy.html) + [src/ghost-copy.js](src/ghost-copy.js) `→ /ghost-copy`, simulator [api/_lib/ghost-copy.js](api/_lib/ghost-copy.js), endpoint [api/pump/ghost-copy.js](api/pump/ghost-copy.js), tests [tests/ghost-copy.test.js](tests/ghost-copy.test.js) | Live (paper only, zero custody) | The bridge between the leaderboard and actually copying someone. Pick a verified trader agent, a budget and a window, and it replays that agent's real closed on-chain round-trips (`agent_sniper_positions`) against a wallet that does not exist, sizing every order through `planCopyOrder`, the SAME function the live [copy-fanout cron](api/cron/copy-fanout.js) uses, so the result is what the copy engine would actually have generated rather than a marketing figure. Deliberately unflattering: P&L per trade is derived from exact chain lamports (never the stored pct column), losing round-trips all count, the ghost wallet has a real cash constraint so capital locked in an open copy blocks the next one, every skip carries a machine reason plus a human sentence, and the leader's still-open positions are marked at THEIR last on-chain quote and reported as unrealized outside the realized headline. Needs no account, no wallet, no signature and no funded signer, so it ships ahead of any custody decision; state lives in the query string so a result is deep-linkable and shareable. Converts into [/vaults](pages/vaults.html) for real money. Doc: [docs/ghost-copy.md](docs/ghost-copy.md). |
| Trader Wrapped (season recap) | [pages/wrapped.html](pages/wrapped.html) + [src/wrapped.js](src/wrapped.js) `→ /wrapped`, deck builder [api/_lib/wrapped.js](api/_lib/wrapped.js), endpoint [api/pump/wrapped.js](api/pump/wrapped.js), social card [api/wrapped-og.js](api/wrapped-og.js), share page [api/wrapped-share.js](api/wrapped-share.js) `→ /wrapped/<agent_id>/share`, tests [tests/wrapped.test.js](tests/wrapped.test.js) | Live (read-only, zero custody) | The artifact the trading stack was missing: one image and one link that say what a season was. Eight slides cut server-side from a trader agent's closed on-chain round-trips (scoreboard, best trade, worst trade, the coin that carried it, rhythm, rank against the field with the nearest rival, receipt), swipeable on touch and keyboard-driven on desktop, with the current slide in the URL hash so a share link lands on the slide the sharer was reading. Arithmetic is delegated wholesale to `computeTraderMetrics` in [api/_lib/trader-stats.js](api/_lib/trader-stats.js), the same truth layer the leaderboard and trader profile use, so a recap can never disagree with the profile it links to. Deliberately unflattering: the worst-trade slide is not optional, the scoreboard carries an explicit verdict and colors a red season red, per-coin ranking includes coins that lost money, self-launched coins stay excluded from every superlative, the rank always prints the size of the real field beside it, and under 3 settled round-trips the page says there is no season rather than drawing a chart out of noise. Needs no account, wallet, signature or funded signer. Converts through [Fork](src/fork-trade.js) on the best-trade slide and links onward to the verified profile, [Ghost-copy](pages/ghost-copy.html) and the rival's own wrapped. Doc: [docs/trader-wrapped.md](docs/trader-wrapped.md). |
| Rivalries (what changed on the trader board) | Engine [api/_lib/rivalries.js](api/_lib/rivalries.js), endpoint [api/sniper/rivalries.js](api/sniper/rivalries.js) `→ /api/sniper/rivalries`, grudge-match strip [src/play/rivalries.js](src/play/rivalries.js) mounted under the leaderboard on [pages/play/arena.html](pages/play/arena.html) `→ /play/arena`, tests [tests/rivalries.test.js](tests/rivalries.test.js) | Live (read-only) | The layer a leaderboard never has: not who is ahead, but who just took whose place. Every trader on the board is paired with the one directly above them and the pair is labelled `overtake`, `debut` or `chase`, with the P&L both sides booked inside the lookback as the reason. Derived from ONE position fetch through the shared `computeTraderMetrics`, run three times: the current window, the same window measured at the lookback cutoff, and the round-trips closed inside the lookback. The past board is re-derived from close timestamps rather than read from a snapshot table, so there is no new table and no cron, it works retroactively from the day it shipped, and it cannot drift out of agreement with `/api/sniper/leaderboard` or with either profile it links to. The copy is assembled from those numbers rather than generated, which keeps a public strip instant, free and checkable: it will not call a trader "behind" when the board ranks on score and that trader actually holds more SOL, and it will not say someone "booked 0.000 SOL" when they simply were not in the market. Ranking boards apply a three settled round-trip floor; the momentum board does not, because one settled trade is the movement it exists to show. Doc: [docs/rivalries.md](docs/rivalries.md). |
+| Trader card embed (a leader on someone else page) | Hosted element [public/trader-card/element.js](public/trader-card/element.js) `→ /trader-card/element.js` (`<trader-card>`), compact read [api/sniper/trader-card.js](api/sniper/trader-card.js) `→ /api/sniper/trader-card`, pure projection [api/_lib/trader-card.js](api/_lib/trader-card.js), snippet builder [src/shared/trader-embed.js](src/shared/trader-embed.js), builder panel on [src/trader.js](src/trader.js) `→ /trader/:id`, tests [tests/trader-card.test.js](tests/trader-card.test.js) | Live (read-only, zero custody) | The funnel that runs on other people sites: one script tag renders a trader's live on-chain record in a stream overlay, a link in bio or a blog post, and every coin on it carries a [Fork](src/fork-trade.js) link plus a [Ghost-copy](pages/ghost-copy.html) call to action, all signed by the reader's own wallet. The leader copies the snippet from their own profile ("Embed this trader"), which renders a live preview of exactly what they are about to paste and bakes in their referral code, so every link the card emits is attributed to them. `/api/sniper/trader` is a quarter of a megabyte for a well-traded agent, which no widget on a stranger's page should pay for, so this endpoint is the few-kilobyte projection of it through the SAME `computeTraderMetrics`: an embedded card can never show a record three.ws would dispute, and an unmeasured number renders `n/a` rather than a zero. Real DOM in a shadow root (selectable, screen-reader readable, keyboard reachable, theme-aware), every link absolute because a relative href on a foreign domain goes to their site, polling that stops when the tab is hidden or the card scrolls off, and a failed refresh that keeps the last good card rather than blanking someone else's page. Doc: [docs/trader-card-embed.md](docs/trader-card-embed.md). |
| Clip Director (content engine) | [pages/clip-director.html](pages/clip-director.html) + [src/clip-director-page.js](src/clip-director-page.js) `→ /clip-director`, brain [api/_lib/clip-director.js](api/_lib/clip-director.js), endpoint [api/clip-director.js](api/clip-director.js) | Live | Turns one real closed trade (`agent_sniper_positions`) into the optimal shareable card per surface (X / Telegram / Feed): honest hook, the real number, an avatar gesture mapped to a real animation clip, CTA, and alt text, plus an on-chain proof link. Losses get an honest card too. Free-first `llmComplete` with a deterministic same-shape fallback. Doc: [docs/clip-director.md](docs/clip-director.md). |
| Atlas (site-wide Cmd+K search + route map) | Palette [public/atlas.js](public/atlas.js) `-> /atlas.js`, ranking [public/atlas/score.js](public/atlas/score.js), map page [pages/atlas.html](pages/atlas.html) + [src/atlas-page.js](src/atlas-page.js) `-> /atlas`, index [scripts/build-atlas-index.mjs](scripts/build-atlas-index.mjs) `-> public/atlas-index.json`, task catalog [data/atlas-intents.json](data/atlas-intents.json), coverage [scripts/inject-atlas.mjs](scripts/inject-atlas.mjs) | Live | **Discovery layer for 650+ routes.** Cmd+K (or `/`) opens a search over every page in `data/pages.json` plus a curated set of TASKS that answer with ordered steps rather than one link, because "which page starts the get-paid flow" is a harder question than "where is /x402/studio". Zero-dependency single file so it runs identically on 250+ standalone HTML entry points; the index is fetched on first open, not page load. Every task step target is resolved against the real route table at build time, so an onboarding path cannot dead-end on a 404. Injected by a Vite `three-ws-atlas` plugin plus a post-build `dist/` walk (same belt-and-suspenders as [scripts/inject-tour-boot.mjs](scripts/inject-tour-boot.mjs), for the same plugin-ordering reason). Embeds and the nav/footer fragments are excluded. Doc: [docs/atlas.md](docs/atlas.md). Tests: [tests/atlas.test.js](tests/atlas.test.js). |
| Internationalization (i18n) | Runtime [src/i18n.js](src/i18n.js) `→ /i18n.js`; catalogs [public/locales/](public/locales) (`en` + 84 locales, `manifest.json`, `localized-pages.json`); pipeline [scripts/i18n-annotate.mjs](scripts/i18n-annotate.mjs) · [i18n-extract.mjs](scripts/i18n-extract.mjs) · [i18n-translate.mjs](scripts/i18n-translate.mjs) (Vertex Gemini, glossary-locked) · [i18n-backfill.mjs](scripts/i18n-backfill.mjs) (re-translates copy that was baked to English during a backend outage); hreflang in [api/sitemap/[type].js](api/sitemap/%5Btype%5D.js) | Live (85 languages) | LobeHub-model client-side copy swap. `npm run i18n:annotate` auto-injects `data-i18n*` into static HTML (byte-surgical), `i18n:extract` builds `en.json`, `i18n:translate` fans it out to every locale via Vertex with brand/protocol terms masked. `i18n:backfill` finds keys whose value is still byte-identical to English (the silent failure mode: a baked fallback is present, so every later run skips it) and re-translates them. Runtime auto-detects locale, mounts a floating `<lang-switcher>`, and injects hreflang. Doc: [docs/i18n.md](docs/i18n.md). Tests: [tests/i18n.test.js](tests/i18n.test.js), [tests/i18n-annotate.test.js](tests/i18n-annotate.test.js), [tests/i18n-backfill.test.js](tests/i18n-backfill.test.js). |
diff --git a/data/pages.json b/data/pages.json
index 79403ec35..0ea41f93f 100644
--- a/data/pages.json
+++ b/data/pages.json
@@ -3457,6 +3457,14 @@
"changefreq": "monthly",
"added": "2026-09-09"
},
+ {
+ "path": "/docs/trader-card-embed",
+ "title": "Docs · Trader card embed",
+ "description": "Put a live three.ws trader on any page with one script tag. The card shows the verified on-chain record and lets readers fork a coin or ghost-copy the trader, signing with their own wallet.",
+ "priority": 0.6,
+ "changefreq": "monthly",
+ "added": "2026-09-09"
+ },
{
"path": "/docs/clash",
"title": "Docs · Coin Clash",
diff --git a/docs/start-here.md b/docs/start-here.md
index db67c0be5..0c71d6341 100644
--- a/docs/start-here.md
+++ b/docs/start-here.md
@@ -144,6 +144,7 @@ Want the model in your hands rather than on a screen? [Materialize](./materializ
- **Following a trader instead of picking?** → [Copy trading](./copy-trading.md): follow a leader two ways, either your agent mirroring real Solana trades inside its own spend policy, or sized intents you sign yourself. Nothing is simulated, so the doc covers the leaderboard weighting, the Smart Money directory, and how performance fees accrue
- **Found a coin and want to act on it now?** → [Fork a trade](./fork-trade.md): one tap on any coin across the Radar, the Live Trade Feed, the Smart Money Radar, or a ghost-copy replay opens the real pump.fun trade panel for it, pre-filled with the size being forked and signed by your own wallet. No custody, no delegated key, the same safety firewall as every other trade surface, and a `?fork=` link so a coin can travel to X or Telegram and open the panel on arrival
- **Not ready to risk money on a trader yet?** → [Ghost-copy](./ghost-copy.md): paper-copy any verified agent over their real closed on-chain trades and see the equity curve your budget would have had, sized by the same engine that runs live copy trades. No wallet, no signature, no account, and every trade your budget could not reach is listed with the reason
+- **Have an audience of your own?** → [The trader card](./trader-card-embed.md): one script tag puts a trader's live on-chain record on your site, blog, link in bio or stream overlay, with a Fork button on every coin and a ghost-copy call to action, all signed by the reader's own wallet. It carries your referral code, holds no funds and asks for no key
- **Want to know what just changed on the board?** → [Rivalries](./rivalries.md): every trader on the arena leaderboard is paired with the one directly above them and labelled an overtake, a debut or a standing chase, with the profit both sides settled in the last 24 hours as the reason. Worked out by rebuilding what the board said at the cutoff from the trade timestamps, so it reaches back over history already recorded and never disagrees with the leaderboard
- **Watching identities land on-chain?** → [On-chain deployments](./deployments.md): the live feed of agent identities registering on-chain as it happens, Solana Metaplex Core mints alongside ERC-8004 registrations across 15 EVM chains, with chain footprint and capability stats
- **Building against the API?** → [The developer platform](./developer-platform.md): API keys, usage metrics, signed webhooks, the one-call MCP connection test, and the public tool and skills catalogs, with a runnable example per endpoint
diff --git a/docs/trading-surfaces.md b/docs/trading-surfaces.md
index 53fcf2b2a..3ead1d855 100644
--- a/docs/trading-surfaces.md
+++ b/docs/trading-surfaces.md
@@ -26,6 +26,7 @@ On top of that base layer:
- **Live trades** stream over server-sent events from `/api/pump/trades-stream` (PumpPortal websocket, relayed). PumpPortal gates per-coin trade subscriptions behind an API key funded with at least 0.02 SOL; when it refuses one, the socket stays open and simply never delivers, so the relay forwards that refusal as an SSE `notice` event and the tape shows a degraded state instead of a lit "live" lamp over an empty panel. A malformed `mint` is refused up front with `400 invalid_mint`.
- **Smart-money pedigree** comes from the proven-wallet ledger (`/api/intel/smart-money`).
- **Rivalries** ([the matchup layer](rivalries.md)) turns the leaderboard's own deltas into what changed: who passed whom, who just arrived, and who is closing. It reads the same closed positions the board is ranked from.
+- **Off-site** the same records travel: [the trader card](trader-card-embed.md) renders a trader's live record on any page with one script tag, and every coin on it forks back into the trade panel here.
One naming trap for API users: `/radar` is served by `api/pump/coin-intel.js` and `/coin-intel` is served by `api/pump/intel.js`. The names look swapped; they are two distinct read models over the same engine.
diff --git a/public/llms-full.txt b/public/llms-full.txt
index c7181dfa3..7d0fedbd1 100644
--- a/public/llms-full.txt
+++ b/public/llms-full.txt
@@ -2578,6 +2578,12 @@ URL: https://three.ws/docs/rivalries
What changed on the trader board: who passed whom, who just arrived, and who is closing. Derived from close timestamps rather than a snapshot table, so the matchups work retroactively and cannot disagree with the leaderboard.
+### Docs · Trader card embed
+
+URL: https://three.ws/docs/trader-card-embed
+
+Put a live three.ws trader on any page with one script tag. The card shows the verified on-chain record and lets readers fork a coin or ghost-copy the trader, signing with their own wallet.
+
### Docs · Coin Clash
URL: https://three.ws/docs/clash
diff --git a/public/llms.txt b/public/llms.txt
index 4cdd57f6f..3cad562d2 100644
--- a/public/llms.txt
+++ b/public/llms.txt
@@ -445,6 +445,7 @@ Docs, tutorials, and reference.
- [Docs · Fade Radar](https://three.ws/docs/fade-radar): How the Fade Radar scores a coin's buy side: what makes a wallet a reverse indicator, the 0 to 100 fade score, the verdict bands, and the out-of-sample measurement behind them.
- [Docs · Coin Radar](https://three.ws/docs/radar): Live pump.fun launch intelligence: every new coin scored in its first 90 seconds for bundle vs organic, wallet concentration, dev behaviour, and risk flags.
- [Docs · Rivalries](https://three.ws/docs/rivalries): What changed on the trader board: who passed whom, who just arrived, and who is closing. Derived from close timestamps rather than a snapshot table, so the matchups work retroactively and cannot disagree with the leaderboard.
+- [Docs · Trader card embed](https://three.ws/docs/trader-card-embed): Put a live three.ws trader on any page with one script tag. The card shows the verified on-chain record and lets readers fork a coin or ghost-copy the trader, signing with their own wallet.
- [Docs · Coin Clash](https://three.ws/docs/clash): Token-gated community warfare: every coin community is an army. Hold the coin, enlist, and rally for your faction in timed on-chain battles.
- [Docs · x402 Studio](https://three.ws/docs/x402-studio): The merchant console for running a paid x402 business: products and pricing, payout and agent wallets, real USDC send and receive with .sol resolution, a storefront and pay-button builder, giving, and security.
- [Docs · Fact Check](https://three.ws/docs/fact-check): Sourced fact-checking with cryptographic content attestations, a published accuracy benchmark, and a free daily quota then pay-per-check via x402.
diff --git a/public/sitemap/index.html b/public/sitemap/index.html
index 28b5c7008..f40dd6600 100644
--- a/public/sitemap/index.html
+++ b/public/sitemap/index.html
@@ -96,7 +96,7 @@
<main class="sm-wrap">
<div class="sm-hero">
<h1>Sitemap</h1>
- <p>All 927 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>
+ <p>All 928 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>
<div class="sm-formats">
<a href="/sitemap.xml"><code>sitemap.xml</code> · for search engines</a>
<a href="/llms.txt"><code>llms.txt</code> · for AI agents</a>
@@ -108,7 +108,7 @@
</div>
<div class="sm-filter">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><circle cx="11" cy="11" r="7"/><path d="m21 21-4.3-4.3"/></svg>
- <input id="sm-filter-input" type="search" placeholder="Filter 927 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />
+ <input id="sm-filter-input" type="search" placeholder="Filter 928 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />
<kbd id="sm-filter-kbd" aria-hidden="true">/</kbd>
</div>
<p class="sm-filter-count" role="status" aria-live="polite"><span id="sm-filter-count"></span><span id="sm-filter-hint" aria-hidden="true"></span></p>
@@ -140,6 +140,14 @@
<span class="sm-desc">What changed on the trader board: who passed whom, who just arrived, and who is closing. Derived from close timestamps rather than a snapshot table, so the matchups work retroactively and cannot disagree with the leaderboard.</span>
</a>
</li>
+ <li>
+ <a href="/docs/trader-card-embed">
+ <span class="sm-new-date">Sep 9, 2026</span>
+ <span class="sm-title">Docs · Trader card embed</span>
+ <span class="sm-path">/docs/trader-card-embed</span>
+ <span class="sm-desc">Put a live three.ws trader on any page with one script tag. The card shows the verified on-chain record and lets readers fork a coin or ghost-copy the trader, signing with their own wallet.</span>
+ </a>
+ </li>
<li>
<a href="/globe">
<span class="sm-new-date">Sep 8, 2026</span>
@@ -180,14 +188,6 @@
<span class="sm-desc">Describe a portfolio in a sentence and get a real basket of Robinhood Chain assets: tokenized equities, crypto majors and chain-native tokens in one index. A screen ranks the whole 700-asset universe against the prompt, the weights are committed on-chain as a signed immutable manifest, and a vault holds the basket in kind and rebalances it back to target on a published schedule.</span>
</a>
</li>
- <li>
- <a href="/markets/robinhood/portfolios/universe">
- <span class="sm-new-date">Sep 7, 2026</span>
- <span class="sm-title">Portfolio universe</span>
- <span class="sm-path">/markets/robinhood/portfolios/universe</span>
- <span class="sm-desc">Every asset a Robinhood Chain portfolio may hold, priced live: tokenized equities, crypto majors and chain-native tokens with on-chain liquidity, 24h volume, price change and the NAV premium against each equity's Chainlink feed. Sortable and filterable by asset class.</span>
- </a>
- </li>
</ul>
</section>
<nav class="sm-toc" aria-label="Sections">
@@ -2555,7 +2555,7 @@
<section class="sm-section" id="learn">
<header>
- <h2>Learn<span class="sm-count" data-count>427</span></h2>
+ <h2>Learn<span class="sm-count" data-count>428</span></h2>
<p class="sm-section-desc">Docs, tutorials, and reference.</p>
</header>
<ul class="sm-list">
@@ -3175,6 +3175,13 @@
<span class="sm-desc">What changed on the trader board: who passed whom, who just arrived, and who is closing. Derived from close timestamps rather than a snapshot table, so the matchups work retroactively and cannot disagree with the leaderboard.</span>
</a>
</li>
+ <li>
+ <a href="/docs/trader-card-embed">
+ <span class="sm-title">Docs · Trader card embed</span>
+ <span class="sm-path">/docs/trader-card-embed</span>
+ <span class="sm-desc">Put a live three.ws trader on any page with one script tag. The card shows the verified on-chain record and lets readers fork a coin or ghost-copy the trader, signing with their own wallet.</span>
+ </a>
+ </li>
<li>
<a href="/docs/clash">
<span class="sm-title">Docs · Coin Clash</span>