# Price Alerts

> Pick a threshold on any token and the bot sends you a direct message when the price crosses it — up, down, or both.

**Price Alerts** are a light-touch way of keeping an eye on tokens without staring at the balance screen. Choose a threshold, pick a direction, and the bot delivers a direct message the moment the price moves past your number.

## Setting an Alert

1. Open a token's [detail panel](/docs/wallet/token-details).
2. Tap **⏰ Set Alert**.
3. **Choose a threshold.** Pick one of the presets — **5%**, **10%**, **25%**, or **50%** — or tap **Custom** to enter any value between **0.1%** and **1000%**.
4. **Choose a direction:**
   - **📈 Up** — fire only when the price rises by the threshold.
   - **📉 Down** — fire only when the price drops by the threshold.
   - **↕️ Both** — fire in either direction.
5. The alert is set immediately, with the current price captured as the *anchor price*.

## How Alerts Fire

When the token's price moves past your threshold — relative to the anchor — the bot sends you a direct message with the token, chain, new price, and the percentage move. After firing, the alert **re-anchors to the new price** so the next move is measured from there, and the alert stays active.

## Managing Alerts

From the main menu, tap **⏰ Alerts** to open the full list of active alerts, grouped by chain. Each entry shows:

- The token symbol (tap to open its detail panel).
- The direction — **↑**, **↓**, or **↕**.
- The threshold percentage.
- The token's current market cap.
- A **🗑** link to remove just that alert.

You can also remove an alert directly from the token detail panel — setting a fresh alert on a token replaces any existing alert for the same direction.

## Limits

> **INFO**
>
> There is a per-user cap on active alerts. When you reach it, the bot refuses to save a new one until an existing alert is removed. Open your alerts list and prune anything you no longer need.

## Caveats

- Alerts are measured from the **anchor price**, not from the original price you set the alert at — so a token that moves up past your threshold and back down fires once, not twice.
- A **📈 Up** or **📉 Down** alert only fires in its chosen direction. Pick **↕️ Both** if you want symmetric notifications.
- If the bot is temporarily unable to fetch prices (for example, during a provider outage), alert evaluation pauses and resumes once service is back — no alerts are "lost", but a fast round-trip may only fire once on recovery.