robinhood-options-mobile

Trade Signal Notifications

Configurable push notifications for trade signals generated by the agentic trading system.

Overview

This feature sends push notifications to users when new trade signals are created or when existing signals are updated to BUY or SELL. Users can configure their notification preferences to control which signals they receive.

Features

User Configuration Options

Users can customize their notification preferences with the following settings:

Enable/Disable - Turn notifications on or off completely
Signal Types - Choose to receive notifications for BUY, SELL, or both
Include HOLD - Optionally receive notifications for HOLD signals
Intervals - Filter notifications by time interval (1d, 1h, 30m, 15m)
Symbol Filter - Receive notifications only for specific symbols
Confidence Threshold - Only notify if signal confidence exceeds a threshold (stored as 0-1, displayed as 0-100%)

Notification Triggers

Notifications are sent when:

A new trade signal document is created in the agentic_trading collection with a BUY or SELL signal
An existing trade signal is updated and the signal changes to BUY or SELL

Notification Content (Rich Notifications)

Notifications are delivered as Rich Push Notifications containing:

Title: Symbol and Signal Type (e.g., “AAPL - BUY Signal”)
Body: Price, Confidence Score, and key indicators
Rich Media: Embedded chart image showing trend context
Actions: “View Details”, “Trade Now” buttons for immediate action

This actionable format allows users to assess opportunities without opening the app fully.

Each notification includes:

Signal type (BUY/SELL/HOLD)
Symbol
Current price (if available)
Interval (Daily, Hourly, 30-min, 15-min)
Weighted signal strength (if available; normalized to 0-1 for filtering)
Data payload for app navigation

Rich Notifications

New in v0.26.0, Expanded in v0.32.0

Rich notifications are now supported for:

Trade Signals: (Buy/Sell alerts with charts)
Chat: (Group messages with sender context)
Copy Trading: (Trade alerts and approval requests with action buttons)

Enhancements in v0.32.0:

Added Firestore storage for notification history and search capabilities
Implemented advanced filtering options for notification management
Enhanced search functionality to find specific notifications by symbol, date, or signal type

Notifications now support rich media content to provide immediate context without opening the app.

Charts: A mini-chart of the instrument’s recent price action is displayed directly in the notification.
Data Tables: Key metrics (e.g., Signal Strength, Indicator Summary) are presented in a concise table format.
Action Buttons: Quick actions (e.g., “View Chart”, “Place Trade”) are available directly from the notification.

When a user taps on a trade signal notification, the app will:

Open the app (if not already open)
Navigate directly to the Instrument Details page for the symbol in the signal
Load the relevant instrument data and chart

Technical Implementation

Backend (Firebase Functions)

File: functions/src/trade-signal-notifications.ts

Two Firestore triggers:

onTradeSignalCreated - Listens for new documents in agentic_trading
onTradeSignalUpdated - Listens for document updates in agentic_trading

Both triggers:

Check if the signal is actionable (BUY, SELL, or HOLD)
Query all users with notification settings enabled
Filter users based on their notification preferences
Send FCM push notifications to matching users

Frontend (Flutter)

Models:

TradeSignalNotificationSettings - Stores user notification preferences
Added to User model as tradeSignalNotificationSettings field

Widget:

TradeSignalNotificationSettingsWidget - UI for configuring notification preferences

Navigation:

NavigationStatefulWidget handles incoming notification payloads and routes the user to the InstrumentWidget with the appropriate symbol and signal data. This ensures a seamless transition from notification to analysis.

Data Storage

Notification settings are stored in the user document:

{
  "tradeSignalNotificationSettings": {
    "enabled": true,
    "signalTypes": ["BUY", "SELL"],
    "symbols": ["AAPL", "TSLA"],
    "intervals": ["1d", "1h"],
    "includeHold": false,
    "minConfidence": 0.7
  }
}

Usage

For Users

Navigate to the Trade Signal Notification Settings screen
Enable notifications with the toggle switch
Configure your preferences:
- Select which signal types to receive (BUY/SELL/HOLD)
- Optionally filter by specific symbols
- Optionally filter by intervals
- Set a confidence threshold if desired
Tap the save icon to persist your settings

For Developers

import 'package:robinhood_options_mobile/widgets/trade_signal_notification_settings_widget.dart';

// Navigate to settings
Navigator.push(
  context,
  MaterialPageRoute(
    builder: (context) => TradeSignalNotificationSettingsWidget(
      user: currentUser,
      userDocRef: userDocReference,
    ),
  ),
);

Updating Settings Programmatically

final updatedUser = currentUser;
updatedUser.tradeSignalNotificationSettings = TradeSignalNotificationSettings(
  enabled: true,
  signalTypes: ['BUY', 'SELL'],
  symbols: ['AAPL'],
  intervals: ['1d'],
  includeHold: false,
  minConfidence: 0.8,
);

await firestoreService.updateUser(userDocRef, updatedUser);

Deployment

Deploy Firebase Functions

cd src/robinhood_options_mobile/functions
npm install
firebase deploy --only functions:onTradeSignalCreated,functions:onTradeSignalUpdated

Update Firestore Rules

The rules are already updated in firebase/firestore.rules. Deploy with:

cd src/robinhood_options_mobile
firebase deploy --only firestore:rules

Testing

Test Notification Locally

Create or update a trade signal document in Firestore:

// In Firebase Console or using admin SDK
db.collection('signals').add({
  symbol: 'AAPL',
  signal: 'BUY',
  interval: '1d',
  timestamp: Date.now(),
  confidence: 0.85,
  price: 150.00
});

Ensure your user has:
- FCM token stored in the devices array
- Notification settings enabled
- Settings that match the signal (symbol, interval, confidence)

Debug Notifications

Check Firebase Functions logs:

firebase functions:log --only onTradeSignalCreated,onTradeSignalUpdated

Notification Channels (Android)

The Android notification uses the trade_signals channel. Ensure this channel is created in your Android app:

// In MainActivity.kt or similar
val channel = NotificationChannel(
    "trade_signals",
    "Trade Signals",
    NotificationManager.IMPORTANCE_HIGH
)
channel.description = "Notifications for buy and sell trade signals"
notificationManager.createNotificationChannel(channel)

iOS Configuration

Ensure your iOS app is configured for push notifications:

Enable Push Notifications capability in Xcode
Configure APNs certificates in Firebase Console
Request notification permissions in the app

Future Enhancements

Potential improvements: