Introduction

During earnings season, the OpenClaw AI Earnings Tracker scans the financial calendar for specific tickers (NVDA, MSFT, etc.), searches for report drops, and posts a beat/miss summary with guidance highlights to a Telegram topic. Investors get real-time earnings intelligence without refreshing financial news sites.

Earnings move markets in minutes. Missing a beat or miss by an hour can mean missing a trade. The Earnings Tracker automates the watch, you get the key facts (EPS, revenue, guidance) in one message, the moment the report hits. No Bloomberg terminal required. No manual scraping. Just a Heartbeat task and a Telegram channel.

Quick Wins

  • Watchlist in memory: Store tickers (NVDA, MSFT, AAPL) in a Markdown file. Add/remove without code changes.
  • Two-tier saves money: Script checks calendar + news. LLM summarizes only when a new report is found. Most cycles = zero LLM calls.
  • 15-30 min during earnings: Run Heartbeat every 15-30 min when earnings are expected. Back off to hourly or off when quiet.
  • Cost: ~$5-15/earnings season for 5-10 tickers. Most of the cost is the few cycles when reports actually drop.

How It Works

Heartbeat task runs every 15-30 minutes during market hours when earnings are expected:

  1. Check financial calendar for tickers on watchlist
  2. If earnings expected today, poll news/API for report release
  3. When report detected: extract EPS (actual vs estimate), revenue, guidance
  4. Format summary: "NVDA: Beat on EPS ($0.52 vs $0.48 est). Revenue in line. Raised FY26 guidance."
  5. Post to Telegram topic or DM

Two-tier processing is critical. Tier 1: script fetches calendar + news. If no new report → no LLM call. Tier 2: when report detected, LLM extracts and formats. Result: you pay for tokens only when there's something to summarize. See two-tier processing.

Configuration

Watchlist in memory: NVDA, MSFT, AAPL, etc. Earnings calendar API (e.g., Finnhub, Alpha Vantage). News source for report detection. Telegram for delivery. Two-tier: script fetches data; LLM summarizes only when new report found.

APIs: Finnhub (free tier), Alpha Vantage, or Polygon.io. Most provide earnings calendar + basic fundamentals. For report detection, use news APIs (NewsAPI, Benzinga) or scrape earnings-specific sites. Store API keys in OpenClaw's encrypted credential store.

Watchlist: Keep in ~/clawd/WATCHLIST.md or similar. Format: ticker, company name, notes. The agent reads this at each cycle.

Output Format

Concise, actionable. Example: "MSFT Q2: EPS $2.45 (est $2.38) ✓. Rev $62B (est $61.5B) ✓. Azure +28%. Stock +3% AH." User gets the key facts in one message.

Include: EPS (actual vs est), revenue (actual vs est), key metric (e.g., Azure growth), guidance (raised/lowered/held), and after-hours stock move if available. One line per ticker. Just the good stuff.

Cost & Timing

Cost: ~$5-15 per earnings season for 5-10 tickers. Most Heartbeat cycles find nothing new → zero LLM calls. When a report drops, one summarization = ~500-1000 tokens. A typical season has 20-40 report events. At $3/M tokens, that's ~$0.50-2. Total cost dominated by the few cycles when reports actually hit.

Timing: Run every 15-30 min during earnings windows (typically 4-8 PM ET for many companies). Outside earnings season, reduce to daily or disable. No point polling when no reports are expected.

Pro Tips

  • Pre-market vs after-market: Some companies report pre-market, some after. Adjust Heartbeat schedule. Pre-market: run at 6-7 AM. After-market: 4-8 PM.
  • Deduplicate: Same report may hit multiple news sources. Track "last reported" per ticker. Don't summarize the same report twice.
  • Guidance matters: Beat/miss on EPS is table stakes. Guidance (raised/lowered) often moves the stock more. Always include.
  • Telegram topics: Use a dedicated "Earnings" topic in your channel. Keeps alerts separate from other notifications.

Wrapping Up

Earnings Tracker demonstrates OpenClaw's value for time-sensitive financial workflows. Real-time intelligence, minimal cost, zero manual effort. See OpenClaw finance, Heartbeat, and Telegram setup for configuration.