Watchlist & Alerts

What a watchlist does

A watchlist is a collection of entities — protocols, chains, tokens, oracles, vaults, organisations, or bridges — that Verdict monitors on your behalf. When a rating publishes or a grade changes for any entity on your watchlist, an alert fires.

Managing watchlists

Watchlists live on /dashboard/watchlist. Add an entity from any rating page, configure alert rules, and pick a delivery channel.

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