Alerts let you define conditions on prediction market prices and receive a notification when those conditions are met. For example, you can set an alert to fire when the probability on “Will BTC reach $100k by 2026?” drops below 0.50, or when the index price divergence spikes above a threshold. Alerts are scoped to your authenticated account.
Authentication
A session JWT or SIWE session cookie is required:
Endpoints
List alerts
Returns all alerts associated with your account.
Example request
Sample response
Create an alert
Creates a new price movement alert. Attach the alert to a canonical question or a specific platform market.
Request body
Alert type. Use "price_threshold" to trigger when a price crosses a value.
Alert condition object. The structure depends on type, but typically includes a field to watch, an operator (above, below, equals), and a value.
UUID of the canonical question to watch. Monitors the cross-platform index price.
UUID of a specific platform market to watch. Monitors that platform’s price directly.
Example request
Sample response
Update an alert
Update the condition or toggle the active state of an existing alert without deleting and recreating it.
Request body
Updated condition object.
Set to false to pause the alert without deleting it.
Use is_active: false to temporarily silence an alert — for example, during a period when you know prices will be volatile and you want to reduce notification noise. Toggle it back to true when you want to resume monitoring.
