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

1. 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.

2. 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”.

3. 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 table below for every supported parameter.

4. Choose your notification channels

   Select email, browser push notification, or both. You can update channel preferences at any time from Alerts → My Alerts.

5. 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.

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

{
  "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.