> ## Documentation Index
> Fetch the complete documentation index at: https://retinaos.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Alerts: Get Notified When the Market Matches Your Criteria

> How to create, manage, and act on RetinaOS alerts — filter-based notifications for new tokens, wallet activity, and market conditions.

Alerts are RetinaOS's primary retention and productivity tool. Instead of watching the feed manually, you define a filter and get notified the moment a matching event occurs. Alerts bring you back to the platform with a specific, relevant signal — not a generic notification. When an alert fires, you already know why it fired and exactly where to look.

## Creating an Alert

<Steps>
  <Step title="Open the alert builder">
    Go to **Alerts → New Alert**, or click **Save as Alert** from any saved filter in the discovery feed. If you start from a saved filter, your existing conditions carry over automatically.
  </Step>

  <Step title="Name your alert">
    Give the alert a descriptive name so you can identify it at a glance in your alerts list — for example, *"Early opportunity scan"* or *"Smart money accumulation"*.
  </Step>

  <Step title="Set filter conditions">
    Define the conditions that must be met for the alert to fire. The full set of filter options from the discovery feed is available here. See the [Alert Conditions Reference](#alert-conditions-reference) table below for every supported parameter.
  </Step>

  <Step title="Choose your notification channels">
    Select **email**, **browser push notification**, or both. You can update channel preferences at any time from **Alerts → My Alerts**.
  </Step>

  <Step title="Save and activate">
    Click **Save**. Your alert is now active and will fire the next time a token or wallet event matches your conditions. You do not need to keep Retina Terminal open.
  </Step>
</Steps>

Here is an example of what a tight early-opportunity filter looks like:

```json theme={null}
{
  "name": "Early opportunity scan",
  "filters": {
    "max_market_cap_usd": 2000000,
    "min_liquidity_usd": 100000,
    "exclude_flags": ["wash_trading", "liquidity_pulled"],
    "min_reputation_holders": 2
  },
  "channels": ["email", "push"]
}
```

This configuration matches tokens with a market cap below $2M and at least $100K in liquidity, with no wash-trading or pulled-liquidity flags, where at least two of the top-10 holders carry a Cortex score above 60.

## Alert Conditions Reference

| Condition                  | Type   | Example                                              |
| -------------------------- | ------ | ---------------------------------------------------- |
| `max_market_cap_usd`       | Number | `2000000`                                            |
| `min_market_cap_usd`       | Number | `50000`                                              |
| `min_liquidity_usd`        | Number | `100000`                                             |
| `min_holder_growth_1h_pct` | Number | `10`                                                 |
| `max_token_age_hours`      | Number | `48`                                                 |
| `exclude_flags`            | Array  | `["wash_trading"]`                                   |
| `min_reputation_holders`   | Number | `2` (number of top-10 holders with Cortex score >60) |
| `wallet_address`           | String | Follow a specific wallet address                     |

All numeric conditions accept whole numbers. The `exclude_flags` array accepts one or more flag identifiers — combine them to exclude tokens carrying any of the listed flags.

## Managing Alerts

Go to **Alerts → My Alerts** to see every alert you have created. From this view you can:

* **Edit** — update the name, filter conditions, or notification channels
* **Pause** — temporarily disable an alert without deleting it
* **Delete** — permanently remove an alert

**Pro accounts** can have unlimited active alerts simultaneously. **Free tier accounts** can have up to 3 active alerts at a time. Paused alerts do not count against the Free tier limit.

## Alert Notifications

Each notification — whether delivered by email or browser push — contains:

* The **token name and symbol** (or wallet address, for wallet-based alerts)
* A **one-line AI summary** of why the match is significant
* The **matched filter conditions** that triggered the alert
* A **direct link** to the relevant token page or wallet page so you can open the full context immediately

Click the link in any notification to land directly on the matched token or wallet page with the relevant data already visible.