QuantRugGuard Docs
QuantRugGuard is a Telegram bot that scans Solana continuously for early memecoin opportunities, running every candidate through a multi-layer coordinated-rug filter before a single alert fires. Each token is scored on X-reach Γ on-chain strength into two tiers β β‘ ENTRY (both strong) and π WATCH (one strong) β and operator-controlled tokens are blocked using co-timing + SOL-fingerprint cluster detection. This guide covers every feature in detail.
Getting Access
Join A Lot of Money
QuantRugGuard access comes with membership to A Lot of Money β a private trading community. Every alert posts live in the group; your personal settings and tools live in the bot DM. Membership is $1,000 lifetime, or $500 with any member's referral.
- DM @LarryBroBro on Telegram β mention code QUANT for the referral discount
- Complete your one-time payment β Larry walks you through it
- You're added to A Lot of Money and see every alert live in the group
- Tap βοΈ Settings on any alert to open your private tools in the bot DM
First Steps After Getting Access
- Send /tiers β pick which alert tiers you want. Default is all. Newcomers often start with
/tiers 23for lower noise. - Send /alerts β toggle individual alert types on/off via the interactive menu.
- Send /myset β optionally tighten or loosen filters vs the global defaults. Run with no arguments to see all options.
- Send /settings β review everything in one place.
- You're live. Alerts fire automatically as tokens are detected.
Every alert also has inline buttons so you can instantly check safety, view a chart, add to watchlist, log a position, or get AI analysis β without leaving Telegram.
Video Tutorials
Short walkthroughs of the bot and every major feature β tap a thumbnail to play. New videos drop in here as they're made.
Getting Started
Get access, verify your wallet, and receive your first alert β in under two minutes.
Reading an Alert
Every field explained β tier badge, clusters, cohort, lock-aware concentration, and the buttons.
Rug Protection
How coordinated operator fleets are caught β co-timing, SOL fingerprint, and the layered gate.
Bubble Map
Read the visual holder map β spot clusters, operator fleets, and concentration at a glance.
AI Chat
Ask the AI anything about any token β paste a CA and get an instant read.
Settings & Filters
Tune ENTRY / WATCH tiers, personal filters, quiet hours, and auto-buy modes.
Alert Tiers
Every token that clears the rug filter is scored on two axes β X-reach (engagement on the token's linked X/Twitter post) and on-chain strength (volume-velocity, holder growth, buy pressure, healthy structure). The combination sets the tier, shown as a badge on every alert:
Both signals strong
X-reach and on-chain strength are both high β the highest-conviction setups and the fewest of them. This is where the reach Γ on-chain edge is strongest.
reach_pts Γ onchain_pts β₯ 10One signal strong
Either reach or on-chain strength is strong, but not both β the fat-tail net that still catches most big movers early. More frequent, higher variance.
reach_pts β₯ 4 OR onchain_pts β₯ 4Thread Replies
All follow-up alerts β milestone hits, loss alerts, dev-sell warnings β are sent as replies to the original alert message. Everything about a token lives in one thread, keeping your chat clean.
Reading an Alert
Every alert follows the same layout β watch the walkthrough, or read the field-by-field breakdown below.
βΆ Reading an alert, field by field
The fields, explained
| Field | What it means |
|---|---|
| β‘ / π Tier | ENTRY (reach & on-chain both strong) or WATCH (one strong) β see Alert Tiers above |
| Mcap Β· Vol 5m | Market cap and 5-minute USD volume at the moment the alert fired |
| Holders Β· Top10 | Holder count and top-10 concentration. Clean % is lock-aware β it excludes locked-supply contracts, LP/AMM pools and program PDAs (they aren't real whales); raw % is the unfiltered figure. |
| πΈ Clusters | Coordinated-wallet detection (see Rug Protection below): β none, or β οΈ N coordinated wallets holding Z% of supply. |
| 𧬠Cohort | The launch cohort β the earliest buyers across the first few slots: slot-0 bundlers and slot 1β3 snipers β shown as start% β now%. A cohort that has exited (β 0%) is de-risked. Separate from clusters. |
| π‘ Safety | Mint revoked, freeze revoked, and RugCheck-verified status. |
Alert Buttons
| Button | What it does |
|---|---|
| β‘ Trojan Bot / π Trojan Web | Buy the token via Trojan (Telegram bot or web), CA pre-filled |
| π Chart | DexScreener price + volume chart |
| π¦ X | The token's linked X/Twitter post |
| π½ More | Expands to the deeper views below |
The π½ More menu
| Option | What it shows |
|---|---|
| π Full Report | Every metric β why this tier, full concentration, cohort, clusters, safety |
| π‘ Live | 10-minute live tracker: πΈ Clusters + π Top Holders (Solscan links), refreshing as holders move |
| π€ AI Chat | Ask the AI anything β it reads the live on-chain snapshot and searches X for the narrative |
| πΊ Bubble Map | Visual holder / cluster map with the accurate coordinated-supply % |
Coordinated-Rug Protection
The core of QuantRugGuard is catching operator-controlled tokens β where one entity secretly holds a large share across many wallets and dumps on retail β while letting genuinely organic tokens through. It does this in layers, and the key insight is that amount alone doesn't prove coordination; timing and funding do.
Cohort vs Clusters β two different things
- 𧬠Cohort (launch) β the launch cohort: the earliest buyers across the first few slots β slot-0 bundlers and slot 1β3 snipers. Shown as start% β now%. A cohort that has sold down (β 0%) is de-risked.
- πΈ Clusters (post-launch) β groups among the current top holders that are secretly one operator, detected after launch. Separate from the cohort.
How a real operator is identified
A group of same-size wallets is only flagged as coordinated when it shows one of two operator fingerprints β not just similar balances (organic fans often buy similar amounts):
- Co-timing β the wallets bought within seconds of each other: one person firing many wallets at once. Organic buyers of the same size buy at different times.
- SOL fingerprint β the wallets hold an identical leftover SOL balance because one funder seeded them all. This catches aged, staggered fleets that timing alone misses.
The layered gate
| Layer | What it blocks |
|---|---|
| Coordinated-dump gate | Any token measured at β₯20% coordinated supply (co-timing + SOL) β in backtest this band dumps to near-zero. Suppressed, never alerted. |
| JIT-rug gate | Bundled operators funded from a common source at launch β a common-funder cluster among the top holders. Blocks the classic bundle-and-dump. |
| Send-time re-check | Coordination is re-measured just before an alert goes out; if it has crossed 20% (or was ever β₯20% in the token's history), the alert is dropped. |
| Lock-aware concentration | Locked-supply contracts, LP pools and program PDAs are excluded from top-holder %, so a 50%-"holder" that's really locked liquidity isn't mistaken for a whale. |
Alert Types
Beyond scan tier alerts, the bot fires several follow-up and contextual alert types. Toggle each one individually with /alerts:
| Alert | Description | Fired when |
|---|---|---|
| π Pumping | A previously watched T1 token suddenly regains momentum | Buy ratio spikes above threshold after a quiet period |
| π Graduation | A token on your watchlist graduates from pump.fun to Raydium | Bonding curve completes or raydium_pool field appears |
| π Whale Buy | A tracked whale wallet makes a significant purchase | Tracked wallet buys β₯ configured minimum SOL |
| π Proven Whale | A wallet from your proven-profitable list buys a new token | Same as whale buy but separate toggleable channel |
| π Milestone | Alerted token hits 2x, 3x, 5x, 10x, 20x, 50x, or 100x | Live price check crosses milestone multiple |
| β Loss Alert | Alerted token drops to the loss threshold | Price drops to configured % of alert price |
| π Dev Sell | Developer wallet sells tokens | Helius webhook detects dev wallet transfer out |
| π₯ Dex Paid | Token pays for a DEX boost or ranking | DexScreener boost payment detected |
| π Trending | Periodic DexScreener trending list | Scheduled scan of trending tokens |
Milestone Tracking
Every alerted token is automatically tracked for milestones from the moment the alert fires. You don't need to do anything β just watch the replies come in under the original alert.
Milestones fire as thread replies to the original alert:
| Milestone | Multiple |
|---|---|
| π― First target | 2x |
| π₯ On fire | 3x |
| π₯ Explosive | 5x |
| π Moon | 10x |
| π Supermoon | 20x |
| β Legendary | 50x |
| π Diamond | 100x |
A loss alert fires (also as a thread reply) when the token drops to the configured loss threshold from the alert mcap. Tokens are tracked for 7 days or until resolved.
Personal Filters
The bot runs global filter defaults. You can personalise them with /myset β tighten any filter as much as you want, or loosen up to a set maximum. Your filters are applied on top of the global ones: if the global blocks something, it won't reach you regardless of your setting.
To see what's actively filtering and what your effective values are versus the global defaults:
All Adjustable Filters
| Key | Controls | Unit | Direction |
|---|---|---|---|
| mcap | Minimum market cap | USD | Tighten: raise Β· Loosen: lower |
| maxmcap | Maximum market cap | USD | Tighten: lower Β· Loosen: raise |
| liq | Minimum liquidity | USD | Tighten: raise Β· Loosen: lower |
| maxliq | Maximum liquidity | USD | Tighten: lower Β· Loosen: raise |
| vol | Minimum 5m volume | USD | Tighten: raise Β· Loosen: lower |
| age | Maximum token age | minutes | Tighten: lower Β· Loosen: raise |
| makers | Minimum unique buyers | count | Tighten: raise Β· Loosen: lower |
| buyratio | Minimum buy/sell ratio | multiplier | Tighten: raise Β· Loosen: lower |
| ratio2 | Secondary buy ratio gate | multiplier | Tighten: raise Β· Loosen: lower |
| volmcap | Minimum vol/mcap ratio | % | Tighten: raise Β· Loosen: lower |
| bundle | Maximum bundle % | % | Tighten: lower Β· Loosen: raise |
| top10 | Maximum top-10 concentration | % | Tighten: lower Β· Loosen: raise |
| dev | Maximum dev wallet % | % | Tighten: lower Β· Loosen: raise |
| lpmcap | Minimum LP/mcap ratio | % | Tighten: raise Β· Loosen: lower |
| rug | Maximum rug score | 0β100 | Tighten: lower Β· Loosen: raise |
| socials | Require social links | 0 or 1 | 1 = require, 0 = don't require |
| ta_min | Minimum TA score gate | score | Tighten: raise Β· Loosen: lower |
Choosing ENTRY vs WATCH
Getting too many alerts? The fastest fix is to receive only β‘ ENTRY tokens (both signals strong) and mute π WATCH (the wider, higher-variance net). You control this in the /alerts toggle menu β switch the ENTRY and WATCH channels on or off independently.
Alert Toggles
Send /alerts to get an interactive toggle menu. Tap any alert type to switch it on or off. Changes apply immediately.
Common Toggle Decisions
- Turn off Trending β if you only want bot-scanned signals, not curated trending lists
- Turn off Pumping β if you only want fresh first alerts, not follow-up entries
- Turn off Graduation β if you don't track pump.fun tokens in your watchlist
- Keep Dev Sell ON β it's one of the most useful safety warnings, worth the noise
- Keep Milestones ON β thread replies are unobtrusive and useful for exit timing
AI Trading Profile
Your profile shapes how the AI β both the π€ AI Chat and /ask β responds to you: its risk framing, focus areas, and exit advice. It does not affect which alerts you receive (use /myset for that).
Quiet Hours
Set a time window during which no scan alerts fire. Useful for avoiding 3am pings. Uses UTC hours.
Pause & Resume
Pause your personal alerts without affecting anyone else. Milestone tracking continues while paused β you'll catch up on what hit when you resume.
Portfolio Tracker
Track open positions with live USD and SOL value, unrealised P&L, and 1-hour price change. Prices are fetched from DexScreener each time you open the portfolio.
Adding a Position
Tap πΌ Portfolio on any alert to add it with auto-filled token data, or add manually:
What You See Per Token
- Current USD value and SOL equivalent
- Unrealised P&L β USD amount and percentage
- Multiplier from your entry price (e.g. 2.4x)
- 1-hour price change with arrow indicator
- Status icon β π 5x+ Β· π 2x+ Β· π up Β· β‘οΈ flat Β· π down Β· π΄ -50%+
Portfolio Buttons
Each token in your portfolio has three buttons: π Rescan (live safety + data), β‘ Trade (opens Trojan), and π Remove. A π Refresh P&L button updates all prices in one tap.
Stop Loss & Take Profit
Set automatic price alerts that fire when a token hits your target or your stop. The bot checks live mcap every 90 seconds.
Stop Loss β /sl
Multiplier is 0.01β0.99, representing the fraction of current mcap at which to alert.
Take Profit β /tp
Multiplier must be above 1.0, representing the target multiple of current mcap.
Both at Once β /sltp
Managing Orders
Price Alerts
Set a custom USD price target on any token. You'll be notified the moment it reaches that price.
Or tap π Set Alert on any scan alert. To view and manage your active alerts:
Watchlist
Track tokens without logging a full portfolio position. Tokens on your watchlist receive graduation alerts when they move from pump.fun to Raydium, and the bot rescans them periodically for significant moves.
To add a token: tap π Watch on any alert, safety check, or chart response. Each entry shows the token name, contract address, and when you added it.
Safety Check
Run a full rug check on any Solana token β alerted or not.
Returns a full breakdown:
- Rug score (0β100) β composite safety rating
- Mint authority β revoked = good
- Freeze authority β revoked = good
- LP lock status and duration remaining
- Top 10 holder concentration %
- Bundle detection β % of supply bought via bundler bots
- Insider wallet flags from RugCheck cluster analysis
- Dev wallet current holdings %
Chart
Get a DEXScreener price and volume chart directly in Telegram.
Or tap π Chart on any alert. Charts refresh live from DexScreener at the moment you request them.
AI Chat & Analysis
Tap the π€ AI Chat button on any alert β or send /ai <CA> β to open the full conversational assistant. It reads a live on-chain snapshot of the token and has live web + X search, so it verifies claims and reads the real narrative instead of guessing.
Inside the chat, ask anything β "is this a good entry?", "what's the narrative?", "who are the top holders?" β and it answers from the live data. For a quick one-shot answer without opening the chat, /ask <question> replies inline in Telegram.
The AI understands QuantRugGuard's methodology, so it reasons with the same accurate data the gate uses:
- Coordinated clusters β the co-timing + SOL-fingerprint figure (not naive amount-clustering), and whether the token is organic or an operator fleet
- Cohort vs clusters β the launch cohort (slots 0β3) read separately from post-launch coordination
- Lock-aware concentration β it knows a program-owned "holder" is locked liquidity, not a whale
- Dump risk & flow β top-holder distribution vs accumulation, and the β₯20% dump-gate
- Realizable outcome β it judges on current value, not peak (a 5Γ that dumps to zero is a rug, not a win)
- Narrative & virality β live X search for the story and whether the claims hold up
Bubble Map
Every alert's πΊοΈ Bubble Map button opens a visual map of the token's holders β each wallet a bubble sized by its holdings, with coordinated wallets grouped and linked. It's the fastest way to see whether supply is spread across independent holders or concentrated in an operator fleet.
- Accurate coordinated % β the same co-timing + SOL-fingerprint, lock-aware figure shown in the alert
- Cluster grouping β coordinated wallets are drawn together, so a fleet is obvious at a glance
- Live & interactive β pan, zoom, tap a bubble for its Solscan link; refreshes as holders move
- Fullscreen β expand for a detailed look on mobile
Whale Wallet Tracking
Track specific Solana wallets. When they buy above the minimum SOL threshold, you get an instant alert. Up to 20 wallets can be tracked simultaneously.
Proven Whales
A separate tier for wallets with a proven track record of profitable entries. Proven whale alerts fire on a different toggle to regular whale alerts so you can control each independently.
Win Rate
See the bot's performance β how many alerted tokens hit 2x versus the loss threshold, with breakdown by rolling batch and per-tier stats.
The win rate screen shows:
- Total alerts in the selected batch
- Wins (hit 2x+), losses (hit loss threshold), pending (unresolved)
- Win rate % for resolved alerts
- Projected win rate treating pending as 50/50
- Best and worst performer in the batch
- Navigation buttons to browse older batches
/hours is particularly useful β it shows you which UTC hours historically produce the best win rates so you know when to pay closest attention.
P&L & Daily Summary
/summary also shows live session data: uptime, scan cycle count, tokens currently being watched, alerts sent this hour, and Helius API call count.
A daily summary fires automatically at midnight UTC β a full recap of that day's alerts, wins, losses, best performer, average time-to-2x, and session stats.
History & Live Views
Reading /recent
Each entry in /recent shows: token symbol Β· alert mcap Β· time since alert Β· and one of four statuses:
- β Xx hit β hit that milestone, with peak multiple shown
- β Loss β hit the loss threshold, with peak multiple shown
- β° Expired β 7-day tracking window closed without resolution
- β³ Pending β still being tracked, current peak shown
Filter Stats
See exactly which filters are blocking the most tokens and which signal combinations are producing the best win rates. Useful for tuning your personal filters.
Shows:
- Each filter gate with block count and % of total rejections
- A visual bar showing relative rejection rate
- False positive flags β tokens blocked that would have won
- Best 3 and worst 2 alert hours by win rate
- Top 5 signal combinations by win rate (e.g. "high buy ratio + low rug score")
Market Pulse
Get an instant snapshot of current Solana market conditions β overall health, volume trend, top movers, and a scanner recommendation.
The pulse runs automatically every hour in the background and adjusts the scanner's aggressiveness accordingly. The manual command gives you the current reading on demand.
Maestro / Trojan / Terminal Mode
If you use Maestro, Trojan, or Terminal to auto-buy from alerts, enable the relevant mode. It reformats alerts so the contract address appears exactly once β preventing double-triggers in your trading bot.
You can enable multiple modes simultaneously. Each formats the CA slightly differently β only enable the ones you actually use.
Autobot β Automated Trading
The autobot executes trades via Trojan automatically when an alert fires. It uses your own Telegram API credentials and your own Trojan wallet β you retain complete control and ownership of funds.
Setup β Step by Step
- Get an invite code from the bot owner, then run /autobot join YOUR_CODE
- Go to my.telegram.org β Log in β API Development Tools β Create new application. Copy your API ID and API Hash.
- Send /autobot setapi API_ID API_HASH
- Send /autobot setphone +YOUR_FULL_NUMBER (e.g. +447700900000)
- Send /autobot auth β Telegram will send a login code to your phone
- Send /autobot code 12345 with the code you received
- Send /autobot config to review and set your position size and slippage
- Send /autobot on to activate auto-trading
Autobot Commands
All Commands
π‘ Alerts & Scanning
| Command | Description |
|---|---|
| /alerts | Toggle alert types + the β‘ ENTRY / π WATCH tiers you receive, via interactive menu |
| /myset [key] [val] | Set personal filters. Run with no args to see all options. |
| /myfilters | View your active filters vs global defaults side by side |
| /myset reset | Reset all personal filters to global defaults |
| /settings | View all current settings in one place |
| /pause | Pause your alerts (tracking continues) |
| /resume | Resume your alerts |
| /status | Bot status β uptime, subscribers, scan state |
| /quiet START END | Set quiet hours, e.g. /quiet 23 7 (11pmβ7am UTC) |
| /quiet off | Disable quiet hours |
πΌ Portfolio & Trading
| Command | Description |
|---|---|
| /portfolio | Full portfolio with live P&L, SOL value, 1h change |
| /add CA amount price | Manually add a token position |
| /sl CA mult | Set stop loss (e.g. /sl CA 0.5 = alert at -50%) |
| /tp CA mult | Set take profit (e.g. /tp CA 3 = alert at 3x) |
| /sltp CA sl tp | Set both SL and TP in one command |
| /mysltp | View all active SL/TP orders |
| /cancelsltp CA | Cancel SL/TP for a specific token |
| /watchlist | View watchlist with live prices and Remove buttons |
| /alert CA price | Set a custom price alert for any token |
| /alerts | View and manage your active price alerts |
| /pnl | Full P&L summary (realised + unrealised) |
π Research
| Command | Description |
|---|---|
| /safety CA | Full rug check via RugCheck.xyz |
| /chart CA | Price chart from DexScreener |
| /ai [CA] | Open the π€ AI Chat for a token β full conversation, live data + web/X search |
| /ask [question] | Quick one-shot AI answer inline in Telegram (no webapp) |
| /profile [setting] | Set AI trading profile (degen/safe/scalp/swing/hold) |
| /whales | List tracked whale wallets |
| /provenwhales | List proven profitable tracked wallets |
π Stats & History
| Command | Description |
|---|---|
| /winrate | Win/loss stats with rolling batch navigation |
| /top | Top 10 best alerted tokens by peak multiplier |
| /hours | Win rate breakdown by hour of day (UTC) |
| /recent | Last 10 alerts with status and peak multiplier |
| /history | Your personal scan history (last 5 CAs) |
| /live | All tokens currently tracked for milestones |
| /pending | Your logged entries awaiting 2x or loss |
| /summary | Today's stats + live session info on demand |
| /filterstats | Gate block counts, best hours, signal combos |
| /pulse | Instant market health snapshot |
π€ Auto-Buy
| Command | Description |
|---|---|
| /botmode | Toggle Maestro / Trojan / Terminal mode |
| /botmode maestro | Toggle Maestro formatting on/off |
| /botmode trojan | Toggle Trojan formatting on/off |
| /botmode terminal | Toggle Terminal mode (+ $QUANT buyback fees) |
| /autobot join CODE | Register for autobot with invite code |
| /autobot setup | Full step-by-step Trojan connection guide |
| /autobot on / off | Enable or disable auto-trading |
| /autobot config | View and edit position size, slippage, etc. |
| /autobot status | Connection status and current config |
π Access
| Command | Description |
|---|---|
| /start | Begin access setup and verification |
| /redeem CODE | Redeem an invite code for permanent access |
| /help | Quick reference inside Telegram |
| /commands | Full interactive command list inside Telegram |
FAQ
Why am I getting no alerts?
Check /settings to confirm you're not paused and your tier preference is set. Run /filterstats to see if your personal filters are too strict β if a filter is blocking 100% of tokens, that's your culprit. Run /myset reset to go back to defaults and see if alerts resume.
What's a good rug score?
0 is perfect β no flags. Under 20 is clean. 20β40 warrants extra attention. 40+ is risky. The bot has a global maximum and blocks anything above it, so if an alert shows a rug score it's already passed the gate.
What's the difference between β‘ ENTRY and π WATCH?
ENTRY means both signals are strong β the token's linked X post has real engagement and its on-chain momentum is strong. WATCH means only one of the two is strong. ENTRY is higher-conviction and rarer; WATCH is the wider net that still catches most big early movers. Both have already cleared the full coordinated-rug filter.
Do Maestro/Trojan modes affect other users?
No. Bot mode only changes how alerts are formatted in your private chat. Other users see the normal format regardless of your settings.
How is win rate calculated?
A "win" is any alerted token that hits 2x (or your configured TP). A "loss" is any token that hits the loss threshold. Pending tokens (not yet resolved) are excluded from the resolved rate but shown in the projected rate (assuming 50/50).
My $QUANT access was revoked β why?
The bot periodically re-checks your wallet balance. If you sold below your locked minimum, access is suspended. Rebuy to the minimum and run /start to re-verify β access restores immediately.
How do I get an autobot invite code?
Autobot access is invite-only and limited. Reach out to the creator/developer directly through the Telegram community.
Is the bot down?
Check 170.64.189.62/bot-status for live status. The systemd service typically restarts within 60 seconds if it crashes.