QuantRugGuard Docs

QuantRugGuard is a Telegram bot that scans Solana every 10–60 seconds for early memecoin opportunities, running every candidate through a 7-layer rug filter before a single alert fires. This guide covers every feature in detail.

Getting Access

Method 1 — $QUANT Token (Free Forever)

Hold $100+ USD worth of $QUANT and verify your wallet. Access lasts as long as you hold the minimum.

1. Buy $QUANT on pump.fun — CA: CLXvUMkjMifxxmJqpQRRbfGGiSMTQn4SyrKWNgjWpump
2. Send /start in the bot
3. Tap Verify Wallet and open the signing link
4. Sign the message in Phantom or Solflare — nothing moves, it only proves ownership
5. Access granted immediately

Method 2 — SOL Subscription (1.001 SOL / month)

Send your unique SOL amount to the payment wallet. The bot detects your on-chain payment within 5 minutes and grants 30 days of access. A 24-hour grace period applies on expiry.

1. Send /start to receive your unique payment amount
2. Send exactly that amount of SOL to the provided wallet
3. Wait up to 5 minutes — access activates automatically
4. Renew by sending the same amount again before expiry

Method 3 — Invite Code

Redeem a code from the creator/developer for permanent access.

First Steps After Getting Access

1. Send /tiers — pick which alert tiers you want. Default is all. Newcomers often start with /tiers 23 for lower noise.
2. Send /alerts — toggle individual alert types on/off via the interactive menu.
3. Send /myset — optionally tighten or loosen filters vs the global defaults. Run with no arguments to see all options.
4. Send /settings — review everything in one place.
5. 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.

Scan Tiers

The bot runs four scanner layers simultaneously, each targeting tokens at a different lifecycle stage. All pass the same rug filter — only the mcap range and source differ.

Thread Replies

All follow-up alerts — pumping confirmations, 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 is structured identically. Here's what each field means:

Signal Score vs Rug Score

• Signal Score (0–100) — measures momentum quality: buy ratio, vol/mcap ratio, holder velocity, maker count. Higher is a stronger signal.
• Rug Score (0–100) — measures danger: top-10 concentration, dev holdings, LP status, bundle %. Lower is safer. The bot blocks anything over the configured threshold — you only see tokens that passed.

Alert Buttons

Every alert has inline action buttons:

Alert Types

Beyond scan tier alerts, the bot fires several follow-up and contextual alert types. Toggle each one individually with /alerts:

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:

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

Tier Selection

Getting too many alerts? Narrowing tiers is the fastest fix. Use /tiers to view your current setting and all options.

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 (/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 Token Analysis

Ask the AI to analyse any token. It pulls live data from DexScreener, pump.fun, and RugCheck then gives you a structured assessment shaped by your /profile settings.

Or tap 🤖 Ask AI on any alert. The analysis covers:

• Token fundamentals — mcap, liquidity, volume, age
• Safety flags and green lights
• Momentum quality and buying pattern assessment
• Social presence and narrative
• Entry and risk opinion (shaped by your profile)

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

1. Get an invite code from the bot owner, then run /autobot join YOUR_CODE
2. Go to my.telegram.org → Log in → API Development Tools → Create new application. Copy your API ID and API Hash.
3. Send /autobot setapi API_ID API_HASH
4. Send /autobot setphone +YOUR_FULL_NUMBER (e.g. +447700900000)
5. Send /autobot auth — Telegram will send a login code to your phone
6. Send /autobot code 12345 with the code you received
7. Send /autobot config to review and set your position size and slippage
8. Send /autobot on to activate auto-trading

Autobot Commands

All Commands

📡 Alerts & Scanning

💼 Portfolio & Trading

🔍 Research

📊 Stats & History

🤖 Auto-Buy

🔑 Access

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 T1A and T1B?

T1A fires immediately after a token graduates from pump.fun to Raydium — it's already tradeable on Raydium when you get the alert. T1B fires while the token is still on pump.fun's bonding curve, before graduation. T1B entries are earlier but carry the risk the token never graduates.

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.