Alert Notifications

Get email notifications when Trust Scores change or token unlocks approach.

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)

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

Alert Types

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

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

Privacy

• Emails are stored only for subscription management
• 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