Create an Alert

There are two ways to put an alert on a token you’re already tracking. The CLI is fastest if you know the exact level you want. The inline path walks you through it and is the only way to create a percent-change alert.

The two paths

1. /setalert <contract> <type> <comparison> <value>. Type the whole alert in one line. Covers price and mcap only.

2. Tap 🔔 on /detailed. Open /detailed, tap the bell next to any token, and pick from a three-row keyboard: Price Above / Below, MCap Above / Below, or Price Change %. Then type the target value when Prysm asks.

Both paths require the token to already be on your watchlist — add it with /add or by pasting the contract first.

/setalert command shape

The CLI takes four arguments in this order:

/setalert <contract> <type> <comparison> <value>

Argument	Accepts
<contract>	Any contract Prysm recognises (EVM, Solana, TON, Tron, Sui).
<type>	price or mcap. Percent-change is not available here — use the inline path.
<comparison>	above or below.
<value>	A plain number, or shorthand 1k / 1.5M / 1B (case-insensitive, optional space).

Anything missing or malformed and Prysm replies with the usage hint instead of creating the alert.

Three examples

/setalert 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 price above 1.20
/setalert 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 mcap below 500k
/setalert 7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr mcap above 100M

The first watches for an absolute price crossing $1.20. The second watches market cap dropping under 500,000. The third uses Solana plus shorthand — fires when MCAP goes above $100,000,000.

Confirmation

If everything checks out, Prysm replies with one line:

Alert created successfully! You will be notified when the condition is met.

The alert is now live. You can review or edit it any time from /alert.

What can fail

• Bad shape. Less than four arguments and Prysm replies with the usage hint plus two examples.
• Bad value. Anything parseShorthandNumber can’t read (e.g. 1.5x, abc, negative numbers) returns ❌ Invalid value. Use regular numbers or shorthand (e.g., 100, 1.5k, 10M, 1B).
• Contract not found. ”❌ Invalid token address or token not found” — the contract isn’t valid or no DEX pair indexes it.
• Not on your watchlist. ”❌ You are not tracking this token. Please add it to your watchlist first with /add.” /setalert never auto-adds — track the token first, then set the alert.

The inline 🔔 path

Send /detailed to see one card per tracked token. Each card has a tappable 🔔 next to the symbol. Tapping it opens a DM with Prysm and shows the alert-type picker:

🔔 Set Alert for PEPE

💰 Price: $0.0₅1234
📊 Market Cap: $5.2M

Choose alert type:

[📈 Price Above]  [📉 Price Below]
[🚀 MCap Above]   [📊 MCap Below]
[📊 Price Change %]

Tap one of the five buttons. Prysm edits the message to ask for the target value, you reply with a number (or shorthand for MCap), and the alert is created — same confirmation string as the CLI.

The bottom row, Price Change %, is the only place this alert type can be created. It doesn’t exist on the CLI.

Note

The 🔔 in /detailed is a deep link — tapping it inside a group chat opens your DM with Prysm and asks you the alert questions there. Group alerts are still attached to the group context if you started from the group’s /detailed.

How percent-change alerts work

A percent-change alert fires when price moves up or down by your target percentage from a fixed baseline. The baseline is the token’s price at the moment you set the alert — Prysm captures it then and stores it on the alert.

So if PEPE is sitting at $0.00001234 and you set a 25% change alert, Prysm pings you when the price reaches either $0.00001543 (25% up) or $0.00000926 (25% down). After the alert fires, the baseline resets to the new price and the next 25% move triggers the next ping — see Notifications and resets for the reset behaviour.

The “Choose alert type” screen tells you the exact baseline it captured:

The baseline price is: $0.0₅1234

If the token has no price data at the moment you tap the button, Prysm refuses to create the alert rather than baseline at zero.

Alert types side-by-side

Type	Created via	Compares	Baseline
Price	CLI or 🔔	Current price vs target	None — absolute.
Market Cap	CLI or 🔔	Current MCAP vs target	None — absolute.
Percent Change	🔔 only	Current price vs baseline	Price at creation.

Walkthrough

You’re already tracking PEPE on Ethereum and want a heads-up if it doubles or halves. That’s a 100% change alert — only the inline path can do it.

1. Send /detailed in your DM with Prysm. Find the PEPE card.

2. Tap 🔔 next to the symbol. Prysm replies with the alert-type picker.

3. Tap 📊 Price Change %. The message rewrites to a prompt asking for the target percentage and shows the baseline price it just captured.

4. Reply 100. No % sign needed. Prysm creates the alert and confirms.

If you’d wanted an absolute price-above-$1 alert instead, the CLI shortcut is faster:

/setalert 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 price above 1

Same confirmation message, same alert in your /alert list.

Where to next

Manage alerts Review, edit, and delete alerts from /alert — including the inline keyboard.

Notifications and resets What firing looks like, how the percent-change baseline resets, and where the ping lands.

Alerts overview The three alert types and when each one is the right tool.