US Stocks Earnings Calendar AI Updates to Telegram (Finnhub + Gemini)

Purpose & Audience

This n8n workflow is designed for investors, traders, financial analysts, and community managers who want real-time, structured US stocks upcoming earnings calendar updates directly to their Telegram channels or chats. It’s perfect for anyone running a financial community, managing a trading group, or tracking earnings for personal investment decisions.

What It Does

1. Fetches upcoming earnings calendar for US-listed stocks using the Finnhub API (free-tier), with a default window of the next 3 days (customizable to any date range).
2. Uses Google Gemini AI to automatically format and structure the earnings data into a clean, grouped, and enhanced message, including company names, tickers, quarters, estimated EPS, and revenue (with intelligent scaling for billions/millions).
3. Sends the formatted earnings update directly to your chosen Telegram chat or channel via a Telegram bot.

Who Is It For?

• Retail and professional investors
• Financial influencers and Telegram group admins
• Trading desk or community managers
• Anyone who wants hands-off, AI-powered earnings alerts for US stocks

How to Set Up

1. Get Finnhub API Key:
   Sign up at https://www.finnhub.io and copy your API key.
2. Connect Google Gemini (or OpenAI) Model:
   Add your Gemini API credentials in n8n for advanced AI formatting and structuring of earnings updates.
3. Set Up Your Telegram Bot:
   Create a bot with @BotFather, get your API token, and add it to n8n’s Telegram credentials.
   Obtain your Telegram chat or group ID (use @RawDataBot for this).
4. Customize Date Range (Optional):
   By default, the workflow fetches earnings for the next 3 days, but you can adjust it to any custom window (e.g., today to 7 days in the future).
5. Activate the Workflow:
   Schedule how often you want updates (default: every 3 days; can be as frequent as daily).
   The workflow will automatically fetch, format, and send the latest US earnings calendar to your Telegram.

Key Features

• No coding required—fully automated and customizable.
• Handles Telegram’s message length limit by default.
• AI-enhanced formatting for maximum readability and engagement.
• Free to use with Finnhub’s free API tier.