Skip to main content

​
Price alerts

Price alerts notify you in real-time when a market’s price crosses a threshold you’ve set. They work independently from watchlist alerts — you can set specific directional thresholds on any market.

​
Setting an alert

The AlertManager component appears in the market detail panel:
1

Open a market

Click any market card to open the detail panel.
2

Configure alert

In the alert section, set:
  • Direction: Above or Below
  • Threshold: Percentage (0-100%) — the price level that triggers the alert
  • Recurring: Toggle on if you want the alert to re-trigger after firing (otherwise it fires once and deactivates)
3

Create alert

Submit the form. The alert is stored in the price_alerts table in Supabase, linked to your wallet address, the market’s condition_id, token_id, and outcome.

​
Managing alerts

​
Notification delivery

When an alert triggers:
  1. A notification is created in the alert_notifications table
  2. The NotificationCenter bell icon (top-right of the Markets page) updates with an unread count badge
  3. A WatchlistAlertOverlay toast slides in from the bottom-right corner
  4. Distinct audio tones play — ascending for price up, descending for price down

​
Notification center

Click the bell icon to see all notifications:
  • List of alert notifications with timestamps
  • “Mark all as read” button
  • Click any notification to mark as read and jump to the market
  • Unread count badge (red) on the bell icon

​
Toast alerts

The WatchlistAlertOverlay component shows toast-style notifications:
  • Market name, direction of movement, new price
  • Auto-dismiss after 5 seconds if not interacted with
  • Click to open the market detail panel

​
Data model

Each alert stores:
Alerts require the Supermission tab to be open (or the PWA installed). Push notifications to your phone’s lock screen are not yet supported. If you need to catch a move, keep the tab open.
Combine alerts with limit orders. Set an alert at your target entry price, and a limit order slightly better than the alert threshold. The alert tells you the market is in your zone; the limit order fills you at your desired price.