Troubleshooting

Most issues with Whale Bot come down to a handful of patterns. Work through the symptoms below in order — each one ends with the single action most likely to fix it.

I Added a Watch but I'm Not Getting Alerts

Check in this order:

• Threshold. The default is $10,000. If the wallet mostly moves smaller amounts, no alert will fire. Open the watch and tap 💰 Threshold to lower it.
• Transfer events only. Alerts fire on transfers in or out of the address. On-chain activity that is not a transfer — approvals, contract calls, governance votes — does not generate alerts.
• Token pricing. Tokens without a reliable USD price are skipped, because the bot cannot compare them to your threshold.
• Chain activity. If the wallet genuinely has not moved anything since you added the watch, you will not hear from the bot. Look the address up on a block explorer to confirm.

The Same Transfer Arrived Twice

This can happen right after the bot restarts if a transfer was in flight across the restart boundary. The design errs on the side of "alert once too many" rather than missing a real event — if this is a concern, cross-reference the View TX link on each alert.

I'm at 3/3 but Only Use Two Watches

Every watch — active or not — counts toward the cap. Open the one you no longer want, tap 🗑 Remove, and you are back to two free slots.

A Small-Value Token Fired an Alert

If the token's USD price pushed the transfer value above your threshold at the moment of the trade, the alert fires. Illiquid tokens occasionally spike briefly against their usual reference price.

I'm Seeing USD Values That Look Wrong

The bot prices tokens against public price feeds, which can be noisy for illiquid or brand-new tokens. Use View TX on any alert to see the exact on-chain amount and verify against the chain's explorer for the authoritative number.

The Bot Did Not Respond

• Make sure the input is a command (starts with /) or a button tap — the bot does not respond to free-text messages outside of its setup flows.
• If the bot was briefly offline, send /start again once it is back. Your watches, thresholds, and nicknames are persisted; only the in-progress dialog is reset.

Something Else Is Wrong

Send /start to reset the conversation. Nothing you have set up is lost — only the current dialog state resets. If a problem reproduces after that, try removing and re-adding the watch; the wallet itself is unaffected on-chain.