Alerts

Overview

The Alerts system lets you define rules that trigger notifications when specific events occur. Whether it is a new filing from a company on your watchlist, an unusual insider trade, or a price movement above a threshold, alerts ensure you never miss critical information.

Click to zoom

Alerts are displayed in a unified feed with severity-based color coding (info, warning, critical), type-based filtering, and quick actions for marking as read, viewing details, or navigating to the related filing.

Alert Types

Irora SEC supports several alert types, each designed to monitor a specific category of market event:

• Insider Trade — Triggered when an insider buys or sells shares of a tracked company. You can configure minimum transaction value thresholds and filter by insider role (CEO, CFO, Director, etc.).
• Cluster Detected — Triggered when multiple insiders at the same company trade in the same direction within a defined time window. Includes the cluster conviction score.
• New Filing — Triggered when a new SEC filing is published that matches your criteria (form type, company, or keyword content).
• Price Movement — Triggered when a tracked security moves above or below a specified price change percentage within a given time period.
• Politician Trade — Triggered when a member of Congress discloses a trade in a company on your watchlist.

Creating Rules

Create alert rules through the UI or programmatically via the API. Here is the step-by-step process for creating an alert from the Alerts page:

API Access

Alerts can also be created programmatically via the API. Here are examples in multiple languages:

curl -X POST "https://api.irora.com/v1/alerts" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "NVDA insider cluster",
    "type": "cluster_detected",
    "conditions": {
      "ticker": "NVDA",
      "minInsiders": 3,
      "minValue": 1000000,
      "clusterType": "bullish"
    },
    "channel": "webhook",
    "webhookUrl": "https://api.myapp.com/webhooks/irora"
  }'

The API responds with the created alert object:

{
  "id": "alert_xyz789",
  "name": "NVDA insider cluster",
  "type": "cluster_detected",
  "status": "active",
  "conditions": {
    "ticker": "NVDA",
    "minInsiders": 3,
    "minValue": 1000000,
    "clusterType": "bullish"
  },
  "channel": "webhook",
  "createdAt": "2026-02-27T10:00:00Z"
}

Notification Channels

Alerts can be delivered through multiple channels depending on your plan:

• In-App — All alerts appear in the Alerts feed with unread badges. Available on all plans.
• Email — Receive alert summaries via email. Configure delivery frequency (instant, hourly, or daily digest) in Settings. Available on all plans.
• Slack — Push alerts directly to a Slack channel. Requires Pro or Enterprise plan.
• Webhook — Receive alert payloads at a custom HTTP endpoint. Requires Pro or Enterprise plan.

Alert Settings

Click the "Settings" button on the Alerts page to configure global notification preferences including email delivery frequency, quiet hours (to mute notifications from 10 PM to 8 AM), and channel-specific routing rules.

Managing Alerts

The alert feed supports several management actions:

• Mark as Read — Click the checkmark on any unread alert to mark it as read
• Mark All as Read — Use the bulk action button to clear all unread indicators
• Dismiss — Remove an alert from the feed (with undo support)
• Clear All — Remove all alerts from the feed (with undo support)
• View Filing — Navigate directly to the related SEC filing
• Filter by Type — Use the filter tabs to view only specific alert categories (Insider Trades, Filings, Price Alerts, Custom, or System)

Best Practices

• Layer alerts by urgency — Set up instant email alerts for high-value insider clusters and daily digests for routine new filings. This prevents notification fatigue while ensuring you never miss critical events.
• Use watchlist scoping — Instead of creating separate alerts for each ticker, scope alerts to your watchlists. When you add or remove companies from a watchlist, the alerts automatically adjust.
• Set meaningful thresholds — For insider trade alerts, set a minimum value that filters out routine small transactions. A $500,000 minimum for buys and $1,000,000 for sells is a good starting point.
• Combine with the Explore canvas — Use the Signal Lab to create complex screening flows, then connect an Alert Output node to get notified when the flow produces new results.
• Enable quiet hours — Unless you are monitoring for truly time-sensitive events, enable quiet hours to avoid being disturbed during off-hours.

Frequently Asked Questions