Watchlist & Alerts

What the watchlist does

The watchlist page lists every published Verdict rating — protocols, chains, tokens, oracles, vaults, organisations, and bridges — with its current letter grade and composite score. Star any entity to track it: starred entities float to the top of the list, and the grade-change email toggle applies to your whole starred set.

Managing your watchlist

Everything happens on /dashboard/watchlist. Click the star on a row to start tracking an entity; click it again to stop. Flip on "Email me on grade changes" to get an email whenever a starred entity's letter grade changes — under the hood the toggle creates (or reactivates) a default grade-change alert rule with email delivery. Power users can manage richer rules via the alert-rules API below.

Alert rules via API

The same alert rules can be managed programmatically:

• GET /alert-rules — list your alert rules.
• POST /alert-rules — create a rule.
• DELETE /alert-rules/{rule_id} — delete a rule.

See the API Reference → Pro Utility section on the docs page for the full request/response shapes.

Alert payload

When an alert fires for an entity on your watchlist, the payload captures the rating delta:

{
  "event": "rating.changed",
  "timestamp": "2026-04-28T14:23:11.000Z",
  "delivery_id": "del_abc123",
  "watchlist_id": "wl_xyz789",
  "data": {
    "entity_type": "protocol",
    "entity_slug": "aave-v3",
    "previous": { "composite_score": 88.5, "letter_grade": "AA" },
    "current":  { "composite_score": 84.2, "letter_grade": "A" },
    "domain_changes": [
      { "domain": "security", "previous": 0.92, "current": 0.85 }
    ]
  }
}

Delivery channels

• Email — delivered to your account email. Default for all alert rules. No setup required.
• Webhook — POSTs the signed JSON payload above to a URL you control. HMAC-SHA256 signed; retried on non-2xx with exponential backoff. See the Webhooks guide for signature verification and retry policy.