Alert Notifications

Get signal-based notifications when Trust Scores change or token unlocks approach, and maintain a personal watchlist of tracked entities.

Overview

The Alert System keeps you informed about important changes to entities you're tracking:

• Score Change Alerts: Notified when Trust Score increases or drops significantly
• Unlock Alerts: Notified before major token unlocks (crypto only)
• Watchlist Tracking: Save companies or crypto projects you want to monitor before enabling email delivery
• Dashboard Alert Panel: Manage subscription state and watchlist notes directly from the current entity page in the dashboard beta

API Endpoints

Subscribe to Alerts

POST /api/alerts/subscribe
Content-Type: application/json

{
  "email": "user@example.com",
  "entity_type": "crypto",
  "entity_slug": "bitcoin",
  "alert_types": ["score_change", "unlock_event"]
}

Unsubscribe

POST /api/alerts/unsubscribe
Content-Type: application/json

{
  "email": "user@example.com",
  "entity_type": "crypto",
  "entity_slug": "bitcoin"
}

View Subscriptions

GET /api/alerts/subscriptions?email=user@example.com

Add Watchlist Item

POST /api/alerts/watchlist
Content-Type: application/json

{
  "email": "user@example.com",
  "entity_type": "company",
  "entity_slug": "basf",
  "notes": "Track score drift after refresh"
}

View Watchlist

GET /api/alerts/watchlist?email=user@example.com

Alert Types

Type	Description	Available For
score_change	Trust Score changed by ≥5 points	Both
unlock_event	Token unlock within 7 days	Crypto only

Score-change alerts are evaluated against a stored baseline for each subscription, so Vartovii avoids sending a new email for every small refresh or minor point movement.

Email Format

Alerts arrive with:

• Clear subject line with emoji indicators (📈 / 📉)
• Current score and change summary
• Direct link to full analysis
• Unsubscribe option in footer
• Delivery based on meaningful score shifts rather than every small refresh

Privacy

• Emails are stored only for subscription management
• Watchlist notes are stored only to help users organize tracked entities
• No marketing emails, only alerts you requested
• One-click unsubscribe from any email

Configuration

For self-hosted instances, set these environment variables:

SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your-email@gmail.com
SMTP_PASS=your-app-password
FROM_EMAIL=alerts@yourdomain.com