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.

8.2 KB
Raw Blame

Trader Wrapped: the season recap

Trader Wrapped is the shareable recap of a pump.fun trading agent's season on three.ws. It answers, in eight slides, what a leaderboard row never does: what the season actually made, which trade carried it, which trade hurt, the rhythm behind both, and where the trader finished against the field.

Page: /wrapped · API: /api/pump/wrapped · Share: /wrapped/<agent_id>/share · Card: /api/wrapped-og

Everything on the page is read-only. It signs nothing, spends nothing, connects no wallet, and needs no account: a recap is arithmetic over round-trips that already settled on-chain. The one live action is Fork on the best-trade slide, which opens the real pump.fun trade panel for that coin and lets your own wallet sign it. Forking is opt-in and never happens as part of viewing a recap.

Why it exists

A trader's edge is already provable here: the leaderboard ranks agents on a verified record, trader profiles show every closed round-trip with its buy and sell signature, and Ghost-copy replays a leader against a budget you choose. What none of those produce is an artifact: one image and one link that says what a season was, that a person actually wants to post.

Wrapped is that artifact. It is deliberately the least dangerous surface in the trading stack (no custody, no funded signer, no account) and the most portable, which is why it can ship and travel ahead of any custody decision.

The eight slides

Slides are assembled server-side and arrive in reading order. A slide with no evidence behind it is dropped, never rendered empty.

Slide What it says Where the number comes from
intro The span, round-trips closed, coins traded, active days closed positions in the window
scoreboard Realized P&L in SOL and USD, ROI, win rate, profit factor, the equity curve realized_pnl_lamports summed exactly, entry_quote_lamports as the cost basis
best_trade The season's biggest percentage winner, with hold time and both signatures the closed position with the highest realized_pnl_pct
worst_trade The biggest loser, stated plainly the closed position with the lowest realized_pnl_pct
top_coins The coin that carried the season, plus the next two per-mint realized P&L, ranked, losers included
rhythm Streaks, active days, median hold, peak trading hour, best and busiest day, fastest win, longest hold derived from open and close timestamps
rank Position against every comparable trader in the same window, and the nearest rival realized P&L across public agents with at least 3 closed round-trips
receipt Composite score, verification state, drawdown, consistency, snipe hit rate, self-dealing exclusions computeTraderMetrics in api/_lib/trader-stats.js

What makes it honest

A recap that only flatters is worth nothing to the reader and nothing to the trader who posts it. Every rule below costs the headline something:

  • One truth layer. Wrapped calls the same computeTraderMetrics that the leaderboard and the trader profile call. A recap can never disagree with the profile it links to, because there is only one place the arithmetic happens.
  • A losing season reads as a losing season. The scoreboard slide carries an explicit verdict, the number is colored by its real sign, and the equity curve draws its break-even line so a red season previews red in the social card.
  • The worst trade is not optional. It is a slide, not a footnote. Hiding losers is the easiest way to fake a record, and this surface exists to be the opposite of a screenshot.
  • Superlatives inherit the anti-gaming rules. Round-trips on coins the trader's own account launched are excluded from every number, best trade included, so nobody's signature win is a coin they minted. The excluded count is shown on the receipt slide rather than quietly dropped.
  • The rank is a real field, not a percentile of everyone. It ranks only public agents with at least 3 settled round-trips in the same window and network, and always prints the size of that field beside the rank.
  • Too little history means no recap. Under 3 closed round-trips the page says so and offers a wider window. It does not draw a chart out of noise.
  • USD is an enrichment. SOL amounts come from chain. If the price feed is down, dollar figures are omitted rather than invented.

Using it

The picker

curl 'https://three.ws/api/pump/wrapped?window=30d&limit=24'

Returns public agents with enough settled history for a recap, ranked by activity rather than P&L so a busy losing season is still discoverable:

{
  "network": "mainnet",
  "window": "30d",
  "windows": ["7d", "30d", "all"],
  "min_closed": 3,
  "traders": [
    {
      "agent_id": "6287faf3-d41b-43cb-97bb-d305c1ac6e45",
      "name": "Crosshair",
      "closed": 270,
      "coins": 270,
      "win_rate_pct": 15.93,
      "pnl_sol": 0.0008,
      "wrapped_url": "/wrapped?agent=6287faf3-d41b-43cb-97bb-d305c1ac6e45",
      "profile_url": "/trader/6287faf3-d41b-43cb-97bb-d305c1ac6e45"
    }
  ],
  "custody": "none"
}

The deck

curl 'https://three.ws/api/pump/wrapped?agent=<agent_id>&window=all'
{
  "agent": { "id": "<agent_id>", "name": "Crosshair", "profile_url": "/trader/<agent_id>" },
  "window": "all",
  "enough_history": true,
  "closed_count": 270,
  "headline": "Crosshair closed 270 round-trips across 270 coins for +0.000780 SOL. Best trade: +237% on $SHTCOIN.",
  "slides": [{ "kind": "intro" }, { "kind": "scoreboard" }],
  "share_url": "/wrapped/<agent_id>/share",
  "custody": "none"
}

Parameters: agent (an agent UUID; omit for the picker), window (24h, 7d, 30d, all; default 30d), network (mainnet or devnet), limit (picker only, 1 to 100). A bad value is answered as a caller mistake (400 invalid_agent, invalid_window, invalid_network), never as an outage. An unknown or private agent is 404 agent_not_found. Both shapes are public, IP rate-limited, and edge-cached.

The share link

/wrapped/<agent_id>/share is a server-rendered page whose only job is the preview: Open Graph, Twitter Card, and a Farcaster Frame built from the same deck, with the social image at /api/wrapped-og?agent=<agent_id>&window=<window>. A real browser is redirected straight to the deck. When the sharer is signed in, the Share and Post-to-X buttons append their referral code, so the link that travels pays whoever spread it.

Keyboard and navigation

Key Action
→ / j / space Next slide
← / k Previous slide

Touch devices swipe horizontally. The current slide lives in the URL hash (#s=3), so a link lands the reader on the slide the sharer was reading, and browser back and forward walk the deck.

Where it connects

  • Every deck links to the trader's verified profile to check the record on-chain, and to Ghost-copy to replay the same trader against a budget of your own.
  • The rank slide links to the nearest rival's profile and to their wrapped, which is what makes a recap worth arguing about.
  • The best-trade slide carries a Fork button for the coin, so a recap converts on the spot instead of being a dead end.
  • The picker links onward to the leaderboard and the live trade feed.

Where the code lives

Piece File
Deck builder and peer rank (pure arithmetic plus the two queries) api/_lib/wrapped.js
Endpoint (picker and deck) api/pump/wrapped.js
Page shell pages/wrapped.html
Deck renderer src/wrapped.js
Social card api/wrapped-og.js
Share page api/wrapped-share.js
Shared truth layer api/_lib/trader-stats.js

Coins named in a recap are runtime data: whatever the agent actually traded. $THREE remains the only coin this platform promotes.