Frequently asked.

Using the bot, subscriptions, AI features, and technical details.

General

What is ShoalBot?

A Telegram bot that detects coordinated buys on Solana in real time and adds AI-powered signal analysis. It tracks wallets via a Helius webhook; when 2+ wallets touch the same token, it sends a scored signal.

Which blockchains are supported?

Solana only, for now. BNB Chain is coming soon.

Is there a free trial?

No. Because of bot infrastructure costs (Birdeye, GMGN, Helius APIs) and abuse risk, there is no free trial.

Subscription & payment

What plans are available?
  • Starter ($50/mo): 25 wallets, core AI
  • PRO ($175/mo): 125 wallets, red flags, Rapid Growth, private channel
How do I pay?

Only through the Telegram bot. Run /subscription → pick a plan → pay in USDC, SOL or USDT via Hel.io, with your own wallet (Phantom, Solflare, OKX, Backpack) on Hel.io's checkout page. The bot never connects to your wallet. Payment is not possible from the website.

How long does a subscription last?

One calendar month (starts Jan 4 → ends Feb 4).

Are refunds available?

Cancel within the first 24 hours: full refund (USDC). After 24 hours: no refund. Technical issues are reviewed case-by-case.

Signals & red flags

How is the AI score calculated?

Token score (40%) + wallet score (60%). Full breakdown on the docs page.

What is a red flag?

Signals that fail to clear your filters arrive as red flag messages (PRO only — Starter doesn't receive red flag messages, though the data is still recorded). Four reasons: mcap_below_threshold, mcap_above_threshold, score_below_threshold, top10_above_threshold.

How does the market-cap (MCAP) veto work?

An MCAP veto is no longer instant. The signal enters the same confirmation wait as everyone else, and the decision is made at the end with full analysis: if the market cap recovers into your range a signal is sent, if it dumps nothing is sent. The $25K system floor is unchanged (silent, no message).

Why don't I get back-to-back red flags for the same token?

There's a 2-hour dedup. Even if a token sees heavy activity, the same user gets the same reason at most once every 2 hours. Lower spam risk.

What is Rapid Growth?

A PRO feature. Tokens that hit a red flag are watched for 5 minutes; if new wallets keep buying, +4 bonus points are added (capped at +16). If the threshold is cleared, a "🚀 Rapid Growth" signal is sent.

AI Assistant

What does /ai do?

Available on both plans — 6 buttons: performance, wallets, optimize, 🎲 simulate scenario, weekly, custom question. Data analysis, setting recommendations, simulations. 10 queries/day with a 1-hour cache.

Can I test settings without applying them?

Yes. /ai → 🎲 Simulate scenario, then type one line: min=250k, max=2M, score=40. The bot computes against your real historical data in 3–5 seconds.

Can I run a simulation inside Custom Question?

Yes. /ai → 🎯 Ask a custom question, then ask in natural language: "simulate score=40", "what if I set max to 1M?" The AI parses it, Python does the real math, and the AI explains.

How does the Sunday AI Advisor work?

Every Sunday at 20:30 (Istanbul), an AI settings recommendation arrives in DM. 8 scenarios are compared, and the best one is written up. Hit Apply to enable it immediately, or Reject to snooze it for 14 days.

Data & stats

Could a wallet have been unfairly marked "fail"?

Fixed in May 2026. Signals used to be tagged "rug" if no Helius price data came back (395 entries took an unfair fail). They're now marked unknown and excluded from stats.

Is wallet-learning data recorded on Starter?

Yes — wallet-learning data is now recorded for all users, including Starter. Birdeye outcome-tracking runs only for active PRO subscribers; Starter records are kept but tracking is paused. Upgrade and your history is auto-backfilled; if you never upgrade, the records are deleted after 90 days.

Is my data safe?

Yes. KVKK-compliant processing, secured MongoDB storage. Payments are transparent on-chain. Your wallet addresses are never shared with third parties.

Troubleshooting

No signals coming in
  1. Subscription active? /subscription
  2. Wallets registered to the webhook? /wallets (look for the ✅ icon)
  3. Are your filters too strict? /settings
  4. Are the wallets you track currently active?
The bot isn't responding

1) Check the status of @TheShoalBot, 2) make sure you typed the command correctly, 3) Support: support@shoalbot.com