Skip to main content

Notification System

The configurable notification system provides granular control over what notifications you receive, eliminating spam and allowing you to focus on what matters.

Notification Types​

1. 🟢 New Trading Signals (Default: Enabled)​

When: MA crossover detected (16-day crosses 64-day)

🟢 LONG SIGNAL: SPY
Price: $450.25
16-day MA: $448.50
64-day MA: $445.00

📊 Recommended Position:
Capital: $10,000
Notional: $13,333
Shares: 29
Instrument Risk: 9.0%
Suggested Stop: $429.75 (4.5% below entry)

2. 🔼 Stop Price Updates (Default: Disabled)​

When: Trailing stop price is adjusted by >1%

🔼 Stop Price Updated: SPY
Side: sell
Old Stop: $445.50
New Stop: $450.20
Change: 1.1%
note

Disabled by default to avoid frequent notifications. Enable if you want to be notified of every significant stop adjustment.

3. 📈 Position Changes (Default: Enabled)​

When: New position opened or existing position closed

📈 Position Opened: AAPL
Quantity: 50
Price: $175.50

4. ⚠️ System Errors (Default: Enabled)​

When: Critical system errors occur

⚠️ System Error
Failed to connect to Tradier API

5. 📊 Daily Summary (Default: Enabled)​

When: Once per day at 4:00 PM EST

📊 Daily Trading Summary

Open Positions: 3
Total Position Value: $25,000.00
✅ Total P&L: $+1,250.00

Signals Today: 2
  🟢 SPY LONG
  🔴 QQQ SHORT

6. 🔔 Market Open/Close (Default: Disabled)​

When: Market opens or closes

🔔 Market Open

How to Configure​

Via Web Interface​

  1. Login to your account
  2. Navigate to Settings (/front)
  3. Scroll to "Notification Preferences" section
  4. Check/uncheck notification types you want
  5. Click "Save Notification Preferences"

Your preferences are automatically saved and apply immediately.

Default Settings for New Users​

✅ New Trading Signals
❌ Stop Price Updates (too frequent)
✅ Position Changes
✅ System Errors
✅ Daily Summary
❌ Market Open/Close

Smart Features​

Frequency Limiting​

Stop Price Updates:

  • Only notifies if stop price changes by >1%
  • Maximum one notification per hour per symbol

Daily Summary:

  • Sent only once per day at 4:00 PM EST
  • Not sent if no activity

Overtrading Prevention​

The signal detection system won't spam you with consecutive signals in the same direction for the same symbol. You'll only get a new LONG signal after a SHORT signal (and vice versa).

API Endpoints​

Get Notification Settings​

GET /api/notification-settings

Response:

{
  "settings": {
    "enabled": true,
    "event_types": {
      "new_signals": true,
      "stop_updates": false,
      "position_changes": true,
      "system_errors": true,
      "daily_summary": true,
      "market_status": false
    },
    "frequency_limits": {
      "stop_updates_interval": 3600,
      "daily_summary_time": "16:00"
    }
  }
}

Update Notification Settings​

POST /api/notification-settings
Content-Type: application/json

{
  "settings": {
    "event_types": {
      "new_signals": true,
      "stop_updates": true
    }
  }
}

Troubleshooting​

Not receiving any notifications​

  1. Check that Telegram bot token and chat ID are configured
  2. Verify notification preferences are enabled
  3. Test with "Send Test Notification" button
  4. Check that you've started a conversation with your bot

Receiving too many notifications​

  1. Disable "Stop Price Updates" (most frequent)
  2. Disable "Market Open/Close" if not needed
  3. Adjust frequency limits if needed

Settings not saving​

  1. Make sure you're logged in
  2. Check browser console for errors
  3. Verify API endpoint is accessible