Telegram Notifications

Funding History Search can send alerts to your Telegram account via a bot integration. This keeps you informed about your portfolio positions without needing to keep the app open.

Setup

1. Click the bell icon (🔔) in the top bar
2. In the modal that appears, click Generate Link
3. The system generates a unique token and registers your portfolio with the notification service
4. A Telegram link appears — click it to open the bot in Telegram
5. Start the bot in Telegram to activate notifications

That's it — your portfolio is now connected.

How It Works

• A unique UUID token is generated per browser and stored in localStorage
• When you click Generate Link, the app sends a POST /api/notifications/register request with your token and current portfolio positions
• The backend returns a Telegram bot link personalized to your token
• Once you start the bot in Telegram, it associates your Telegram account with your portfolio data

Portfolio Auto-Sync

Every time your portfolio changes (add, edit, or remove a position), the app automatically re-syncs the updated portfolio to the notification service. Changes are batched with a 1.5-second delay to avoid sending too many requests during rapid editing.

Regenerating the Link

If you need to unlink your current Telegram account and start fresh:

1. Open the notification modal (bell icon)
2. Click Regenerate
3. A new token is created, the old link is cleared
4. Click the new Telegram link to connect a different account

Browser-Specific Token

The notification token is stored in your browser's localStorage. If you clear browser data or switch to a different browser, you will need to generate a new link. This also means notifications are per-browser, not per-account.

Status Indicators

The notification modal shows your current status:

State	Display
Not linked	Generate Link button
Linked	Success message + Telegram button + Regenerate option