Manage Alerts
/alert is the dashboard for everything you’ve set. One message, every
active alert grouped under its token, with two tappable emoji per row —
✏️ to edit the target value, ❌ to remove it. Both icons are Telegram
deep links back into your DM with the bot, so you never leave Telegram
and you never need to remember an alert ID.
/alert — the overview
Section titled “/alert — the overview”Send /alert in your DM with the bot. You get one message back with:
- A header showing how many alerts are active and your limit
(e.g.
🔔 Alerts Overview (4/10)). - One block per token, with the token symbol on top and every alert on that token listed underneath.
- Each alert row shows the threshold and
✏️ ❌to its right.
Token groups are sorted by closest alert first — whichever token has an alert nearest to firing shows up at the top.
🔔 Alerts Overview (4/10) 🔹 PEPE Price > $0.000018 ✏️ ❌ $0.000025 ✏️ ❌ % Change: ±15% ✏️ ❌ - - - - - - - - - - - - - - - 🪙 BONK MCap < $1.5B ✏️ ❌
The leading chain icon (🔹 for ETH/Base, 🪙 for SOL, 🔸 for BSC, 🟣 for Polygon, 🔺 for Avalanche, 🔷 for Arbitrum, 🔴 for Optimism, 💎 for TON, 🌊 for SUI, ⚡ for Sonic) is rendered as a Telegram custom emoji — the fallback shown above is what you’ll see on clients without custom-emoji support.
The dotted line separates one token group from the next.
Edit an alert
Section titled “Edit an alert”The ✏️ next to any alert row is a deep link to your DM with the bot.
-
Tap ✏️ on the row you want to change.
-
Telegram opens the bot’s DM (or stays in it if you’re already there) and the bot replies with a prompt:
✏️ Edit Alert for PEPE Current: Price above $0.000018 Enter new target value: (e.g., 100, 1.5k, 10M, 1B)
-
Reply with the new number. Plain numbers and shorthand both work —
100,1.5k,10M,1B. -
The bot updates the alert, deletes the prompt and your reply to keep the chat clean, and posts a short confirmation that auto-deletes after 10 seconds:
✅ Alert updated successfully! New target value: $0.000020
Editing also re-arms the alert. If the alert had already fired (so it was sitting idle waiting to be reset), bumping the target value flips it active again so it can fire on the new threshold.
Remove an alert
Section titled “Remove an alert”The ❌ next to any alert row works the same way — tap, the bot removes that one alert, and the overview message is updated.
-
Tap ❌ on the alert you want to drop.
-
The bot deactivates the alert and posts a short confirmation that auto-deletes after 5 seconds:
✅ Alert for PEPE has been removed.
-
Your existing
/alertoverview message is edited in place to reflect the change — no scrollback clutter, no second copy of the list. If the removal was the last alert on a token, the entire token group disappears.
Behind the scenes, the bot caches the message ID of your most recent
/alert overview (under alert_overview_msg:<user>:<chat>) for an
hour after you run the command. As long as that cache entry is live,
edit and remove actions update the original overview message instead
of posting a new one.
If the cache has expired or the original message is gone, you just get a fresh overview as a new message. Either way the alert change itself goes through.
Empty state
Section titled “Empty state”When you have no active alerts, /alert shows a help message instead
of an empty dashboard:
🔔 Alert Dashboard (0/10) No active alerts yet. How to set an alert: Use /detailed to view your tokens, then tap the 🔔 bell emoji next to any token. [➕ Add Alert]
The same empty-state message appears after you remove your last alert — in that case the existing overview message is rewritten to a longer help block explaining the alert system, so the message you’ve been tapping in the chat doesn’t suddenly become useless.
DM only by convention
Section titled “DM only by convention”/alert runs anywhere — but the ✏️ and ❌ icons are
https://t.me/<bot>?start=… deep links that always open your DM with
the bot. So if you run /alert in a group, the overview is rendered
publicly to every member, but every interactive icon bounces you out
to your DM anyway.
In practice: keep /alert in your DM. Alerts are personal — they fire
in your DM, the limit (alertLimit) is per-user, and there’s nothing
group-shaped about them. Running /alert in a group just leaks your
list.