Trenches Widget
Trenches is a real-time pump.fun launch monitor and news-reactive memecoin sniper docked beside the News Feed. It ingests every new token as it's minted, enriches it with socials + safety data, and — its standout feature — races the coins a live news post mentions against each other in real time, all in a dense, green-themed panel built for fast triage.
The Three Tabs
| Tab | What It Shows |
|---|---|
| New | The live firehose of fresh pump.fun mints, run through your filters and sort. This is the default browse view. |
| Hits | Only the coins currently inside a news-mention sprint — i.e. a live news post just referenced them. Sorted by market cap, highest first. |
| Winners | Coins that won their news-mention sprint. Retained for a configurable window (default 12 hours) with live MC/volume tracking. |
All tabs pull from the same live source — PumpPortal WebSocket — and share enrichment state. A token is never fetched twice.
New
The default tab and the raw stream: every new pump.fun mint, virtualized and sorted newest-first (or by your chosen sort). Apply filters here to bias the firehose toward launches worth watching.
News-Mention Sprints (Hits)
When a post in the News Feed references a token in the current stream, that coin enters a 90-second sprint. While the sprint runs:
- The coin appears in the Hits tab (sorted by market cap)
- A live crown rides on whichever sprinting coin has the highest recent activity score
- On tabs other than Hits, a compact sprint peek strip shows the current leader
- Optionally a hero alert + Telegram forward fires the moment a coin first matches
One sprint per coin — a coin whose 90s window expired can't immediately re-enter.
Winners
When a sprint ends (early or on the timer), its leader is recorded as a Winner. Winners persist for the retention window (default 12 hours, configurable in Settings) and stay subscribed to the trade stream so their market cap and volume keep updating live. The card falls back to a snapshot if the engine has already aged the coin out of its 1-hour token cache.
Token Cards
Each card is designed for at-a-glance triage:
- Logo with image fallback and subtle ring outline
- Ticker and name
- Live market cap in USD, updating from the trade stream
- Age ("2m ago", "4h ago") — fresh tokens (under ~10s old) are flagged
- Bonding curve % and last-trade info from pump.fun
- Program / pool address for routing
- Safety dots — LP burned, mint revoked, freeze revoked
- Socials row — X / Telegram / Website icons when present
- Quick buy buttons — configurable SOL amounts, routed through the Swap engine
- Click-to-chart — anywhere on the card opens the on-chain chart
Hover the logo for an inline circular image preview; click to zoom.
Filters
Open the Filters panel (preset-savable) to narrow the stream:
- Min / Max MC ($)
- Min Holders
- Max Age (sec)
- Max Rug Score and Max Dev Hold %
- Min Liquidity ($)
- Hide Graduated
- Socials Only — require at least one social link
All filters default to off (no restriction). Save filter presets and switch between them from the header.
Settings
The Settings gear opens panel-level controls:
- Position defaults — default SOL size per quick-buy
- Instant-buy slippage — used by quick-buy buttons (shared with Chart / News quickbuy overlays)
- Sound preset — which sound plays on new qualifying tokens; throttled to avoid audio spam
- Instant-match alert — hero alert + Telegram the moment a coin first matches a news item (the sprint-winner alert is always on)
- Telegram forward mode — off / winners-only / all matches
- Winner retention — how long winners stay in the Winners tab (default 12h)
- Panel width and left / right positioning — dock Trenches either side of the News Feed
News → Coin Matching
The engine matches every news item passing through the News Feed against the current Trenches token map using a layered algorithm:
- Symbol match — the news mentions the ticker
- Smart name match — multi-word names are tokenized and matched against news body text, with a confidence score
- Image hash match — the token logo is perceptually hashed (server + client) and compared against images attached to news posts
When a match fires:
- The token card flashes green with a glowing halo and enters its 90s sprint
- A hero alert banner pops (if enabled) and the coin surfaces in Hits
- Telegram forward optionally sends the news item + token link to your paired chat
- A NEWS badge appears on the card; clicking it jumps to the matched news item
- The on-chain chart auto-follows the matched token if the chart is open
Anti-Spam
Launch farms that mint many tokens with the same branding are held in a blocklist and excluded from matching, keeping the hero-alert channel signal-dense.
Confidence Scoring
Name matches carry a confidence value. Low-confidence matches are logged but don't fire alerts; high-confidence matches trigger the full hero/Telegram path. A match-sensitivity threshold is exposed via News Feed settings.
Timing Reference
| Event | Timing |
|---|---|
| News-mention sprint window | 90 seconds |
| Winners retention (default) | 12 hours (configurable) |
| Token cache TTL | 1 hour |
Performance & Persistence
- Virtualized list — handles thousands of tokens without frame drops
- Streaming enrichment — image, socials, and safety dots stream in individually as they resolve
- Server-side proxy — pump.fun + IPFS calls route through an API route to bypass CORS/CSP in production
- sessionStorage persistence — winners survive tab reloads within a session
- Engine lifecycle — the Trenches engine auto-starts and auto-stops based on listener count; no wasted WebSocket connections
Theme
Trenches uses a consistent emerald / green theme throughout: buttons, badges, highlight rings, focus flashes, and hero banners. No hard ring borders on virtualized rows (background pulses only), so rapid updates don't visually flicker.
Buying
The quick buy buttons on each card route through the terminal's Swap engine (Jupiter Ultra on Solana) with your configured slippage and SOL amount. Buys record an on-chain fill with entry price, MC at buy, and a timestamp for time-held tracking. Optional TP / SL can be attached to the resulting holding in Portfolio.
Troubleshooting
No tokens appearing
- Check the connection status dot in the header (green = live)
- PumpPortal WebSocket may be rate-limiting — the client auto-reconnects with backoff
- On New, your filters may be too tight — reset them. Hits/Winners are empty until a news mention fires a sprint.
Images missing or slow
Images come from IPFS via a server-side proxy. Occasional delays are normal; the placeholder logo shows until the image resolves.
Sound not playing
- Confirm a sound preset is selected in Settings
- Browser autoplay policy requires a user gesture — interact with the tab once
News match fires on wrong token
Tighten the match-sensitivity threshold in News Feed settings. If a specific launch-farm name keeps matching, it is likely a spam pattern already handled by the anti-spam blocklist.