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, BNB Chain (BSC) and Robinhood Chain, since July 2026. One subscription covers all of them. BNB Chain and Robinhood Chain are both EVM — a 0x wallet you add is tracked across all supported EVM chains. Other chains are being evaluated.

Is there a free trial?

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

Multi-chain

How do I switch chains?

Open /home in the bot and tap the "⛓ Chain" button at the top, then pick Solana, BNB Chain or Robinhood Chain from the menu. Menus, wallets and settings follow the chain you pick (the active one is marked with a ✓).

Do I add my wallet on each EVM chain separately?

No. You add a 0x (EVM) wallet once and it's tracked on all supported EVM chains — today BNB Chain and Robinhood Chain. Signals and settings are still per chain, so each chain keeps its own track record for that wallet.

Do EVM wallets eat into my Solana quota?

No. Solana has its own quota; EVM wallets (0x) share one quota by unique address across all supported EVM chains. Starter: 25 Solana + 25 EVM. PRO: 125 Solana + 125 EVM.

Do I get signals from every chain at the same time?

Yes. The chain menu only changes what the menus show — signal generation runs continuously for every wallet you track on every chain. BNB Chain and Robinhood Chain signals carry a "⛓ Chain" line so you can tell them apart at a glance.

Is BNB Chain safety-checked like Solana?

Yes, with BSC-native sources (GoPlus security scan plus DexScreener and Birdeye data). Confirmed honeypots, blocked buys/sells, 50%+ taxes and unverified contracts are silently filtered — no signal is sent for them. Missing data alone never fails a token.

Does honeypot screening work on Robinhood Chain?

Not yet. Honeypot screening isn't available on Robinhood Chain yet, so every Robinhood signal carries a clear warning line — trade carefully. The security provider we use, GoPlus, does not support Robinhood Chain yet; when it does, screening turns on automatically.

Will you add Ethereum, Base or other chains?

The architecture is multi-chain by design and new chains are being evaluated. Solana, BNB Chain and Robinhood Chain are supported today — we announce chains when they're live, not before.

Does the Weekly Report or AI Advisor cover BNB Chain or Robinhood Chain?

Not yet — the weekly report and /ai currently analyze Solana data. BNB Chain and Robinhood Chain coverage will follow as their data matures.

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