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, AI Assistant, Rapid Growth, private channel
How do I pay?

Only through the Telegram bot. Run /subscription → pick a plan → pay in USDC or SOL via Hel.io. Payment is not possible from the website.

How long does a subscription last?

One calendar month (starts Jan 4 → ends Feb 4). Same model as Netflix/Spotify.

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. Four reasons: mcap_below_threshold, mcap_above_threshold, score_below_threshold, top10_above_threshold.

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

There's a 12-hour dedup. Even if a token sees heavy activity, the same user gets the same reason at most once every 12 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?

For PRO users, 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 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 @ShoalBot, 2) make sure you typed the command correctly, 3) Support: support@shoalbot.com