Skip to content

Signal notifications via Email (SMTP / SendGrid) #20

@naimkatiman

Description

@naimkatiman

Feature: Email Notifications for Signals

Context

TradeClaw currently supports Telegram and Discord push notifications. Email is the most universal notification channel — many users prefer it for daily summaries or don't use Telegram/Discord.

What to implement

Notification types:

  1. Instant alert — email sent immediately when a BUY/SELL signal fires
  2. Daily digest — summary email of all signals from the last 24h (cron at 8 AM user timezone)

Configuration (in .env):

EMAIL_PROVIDER=smtp        # smtp | sendgrid | resend
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=you@gmail.com
SMTP_PASS=app-password
EMAIL_FROM=alerts@tradeclaw.win
EMAIL_TO=user@example.com  # comma-separated for multiple recipients

Email template:

  • Signal type badge (BUY = green, SELL = red, HOLD = grey)
  • Symbol, confidence %, timestamp
  • Key indicators that fired (RSI: 28, MACD: cross)
  • Link to dashboard

Tech

  • Use nodemailer for SMTP (already in many Node stacks)
  • HTML email template in packages/core/src/notifications/templates/email.html

Acceptance criteria

  • SMTP email sends on new BUY/SELL signal
  • Daily digest cron sends at configured time
  • Email template is readable on mobile
  • SendGrid as optional alternative to SMTP
  • Documented in README notifications section

Good first issue because

Self-contained notification channel addition, well-defined scope, no changes to signal engine.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions