Send Options Flow Alerts Telegram

What It Does

Every 4 hours on US market weekdays, this workflow searches for the top 5 unusual options trades reported in the last 4–8 hours and delivers a structured flow alert to your Telegram. Each trade includes the ticker, contract details (strike, expiry, call or put), total premium spent, volume versus open interest ratio, trade bias (bullish, bearish, or hedge), and any known catalyst. It also includes the market-wide put/call ratio as a broad sentiment signal.

Why It Matters

Large options trades — sometimes called "whale trades" or "smart money flow" — often precede major stock moves by hours or days. A $5 million call sweep on a stock before earnings, or a massive put purchase before a product announcement, gives retail traders a signal that institutional money is positioning for a move. This workflow brings that signal to your Telegram automatically so you can stay informed without manually scanning flow trackers all day.

How It Works

1. Scheduled Trigger — Fires every 4 hours on weekdays, covering pre-market, market open, midday, and close windows when unusual activity is most frequently reported.
2. AI Agent with Internet Search — Searches options flow tracking sources, financial news, and market data sites for the largest and most unusual options trades in the current window.
3. Telegram Message — Delivers a structured 5-trade alert with all key details to your Telegram chat.

What You Get

When no unusual activity is detected or the market is closed, you receive a clear fallback message instead of silence.

Who It's For

• Options traders who follow institutional flow to inform their own trades
• Swing traders who use unusual activity as an early signal before entering a position
• Market watchers who track smart money positioning as a sentiment indicator
• Anyone who has missed a major move and later discovered a clear options signal existed beforehand

Setup

1. Connect your Telegram bot — Create one via @BotFather, then get your chat ID via @userinfobot (takes about 5 minutes).
2. Submit the workflow — Do not publish, to preserve your Needle credits.
3. Install — Flow alerts begin arriving every 4 hours on trading days.

Customize It

• US market hours only — Change the cron schedule to 0 13,17,21 * * 1-5 so alerts fire at 9 AM, 1 PM, and 5 PM ET.
• Share with your trading group — Change the chat ID to a Telegram group so your circle sees the same flow alerts.
• Pair with other workflows — Combine with a swing trade signal workflow for a complete technical and flow-based trading toolkit.

Timezone Note

By default, the workflow fires at UTC hours 0, 4, 8, 12, 16, and 20 on weekdays. Key US market windows:

Adjust the cron to 0 13,17,21 * * 1-5 if you only want alerts during US market hours.