Skip to content

Alerts Overview

An alert is a rule you attach to a token on your watchlist that says “ping me when this number crosses that line.” Prysm watches the price in the background and sends you a Telegram message the moment the condition is met. There are three flavours — absolute price, absolute market cap, and percent change from a baseline — and they all land in the same place: your DM with the bot.

TypeFires whenDirection
PriceThe token’s current USD price crosses your targetabove or below
Market capThe token’s current market cap crosses your targetabove or below
Percent changeThe token’s price moves more than X% from a baselineEither direction (±X%)

The first two are straightforward thresholds — pick a USD value, pick a direction, get pinged when the live price or market cap reaches it. The third tracks movement rather than an absolute number.

Both are absolute alerts. You give Prysm a number and a direction:

  • Above — fires when the current value is greater than or equal to your target.
  • Below — fires when the current value is less than or equal to your target.

Market cap alerts read the live market cap (current price × circulating supply), so even if you anchor your thinking on supply, the comparison is still done in dollars.

A percent change alert is symmetrical. When you create it, Prysm records the token’s price at that moment as the baseline. From then on, every price update is measured against that baseline as a percentage. The alert fires when the absolute change exceeds the threshold you set — so a ±5% alert pings on a 5% move up or a 5% move down, whichever happens first.

After it fires, Prysm doesn’t disable the alert. Instead it resets the baseline to the current price and re-arms, so the same ±5% rule keeps firing on every fresh 5% leg the token takes.

The alert type decides what happens after it fires:

  • Price and market cap alerts are one-shot. Once the threshold is hit and the notification is sent, the alert is marked triggered and deactivated. If you want it to keep watching, create a new one with a fresh target.
  • Percent change alerts are recurring. After firing, Prysm resets the baseline to the current price and the alert keeps watching for the next ±X% move. You only stop getting pinged when you delete the alert yourself.

This is also why a 5% alert can fire many times in a volatile day — each notification represents a new 5% leg, not a cumulative move.

Always your DM with the bot, sent the moment the condition is met. You don’t need to be active in any chat — Prysm initiates the message itself. If your DM with Prysm is closed, opening it brings the unread alerts into view in normal Telegram fashion.

A triggered price or market-cap alert looks like this:

🚨 Price Alert Triggered! 🚨
🔹 PEPE (Pepe)

Price is now above your target!

Alert Details:
Target: $0.00001500
Current: $0.00001523

Token Address:
0x6982508145454ce325ddbe47a25d4ec3d2311933

This alert has been deactivated.

A percent change alert is shorter — just the move and the new price:

🪙 BONK (Bonk)
📈 MCap: $1.85B | $0.00002441 | +5.21%

Reading the standard alert top to bottom:

  • The header confirms which alert tripped, and the row underneath shows the chain emoji, ticker, and full token name. The ticker is a tappable link to your chosen chart provider.
  • Target is the value you set when creating the alert. Current is the value at the moment it fired — usually slightly past the target, since prices move in steps.
  • The footer line This alert has been deactivated only appears on one-shot alerts. Percent change alerts skip it because they re-arm themselves automatically.

You can have up to 2 active alerts at once by default. The cap counts active alerts only — alerts you’ve deleted, and one-shot alerts that have already fired, free up a slot.

If you bump up against the cap, /setalert and the inline alert buttons return a “you have reached the maximum limit” message instead of creating the alert. Delete a few you no longer need with /alert, or contact the bot owner to request a higher cap.

Two entry points to create one:

  • /setalert <contract> <type> <comparison> <value> — typed shorthand. type is price or mcap, comparison is above or below. Shorthand numbers like 1.5k, 10M, 1B work.
  • The 🔔 bell in /detailed — opens an inline picker with buttons for price-above/below, mcap-above/below, and percent change. This is also the only way to create a percent change alert (the baseline is taken from the live price at that moment).

To see what’s armed, run /alert in DM. You get a grouped overview of every active alert per token, with inline ✏️ edit and ❌ remove links on each row.