/earnings-monitor

name: earnings-monitor
description: >-
  Monitor upcoming and recent earnings — calendar, trends, news context, and
  options activity around earnings dates. Use when the user asks about earnings
  season, upcoming reports, earnings surprises, or pre/post-earnings analysis.
version: 0.4.0

Skill: earnings-monitor

Purpose

Track and analyze earnings events using EODHD data — upcoming earnings calendar, historical earnings trends (EPS estimates vs actuals), related news, and intraday price action around earnings dates.

Trigger

Activate when the user asks for:

• Upcoming earnings calendar or "who reports this week"
• Earnings history, surprises, or beat/miss analysis
• Pre-earnings or post-earnings price movement
• Earnings trends and estimate revisions
• Event-driven analysis around earnings dates

Workflow

1. **Determine scope** — specific ticker(s) or date range for calendar view 2. **Fetch earnings calendar** — `calendar/earnings` with date range or symbols 3. **Fetch earnings trends** — `calendar/trends` for EPS estimates, revisions, growth 4. **Fetch related news** — `news` endpoint filtered around earnings dates 5. **Fetch price action** — `intraday` or `eod` around earnings date for reaction analysis 6. **Compile earnings report**

Output Structure

Earnings Monitor — [Ticker or Date Range]

**Upcoming Earnings** | Date | Company | Ticker | EPS Estimate | Revenue Estimate | Time | |------|---------|--------|-------------|-----------------|------|

**Earnings Trends** (for specific tickers)

• EPS trend (last 4 quarters): actual vs estimate
• Revenue trend (last 4 quarters)
• Surprise history (% beat/miss)
• Analyst revision direction (up/down/flat)

**Price Reaction Analysis**

• Pre-earnings drift (5 days before)
• Post-earnings move (day of + next day)
• Historical earnings-day volatility

**Related News**

• Headlines around earnings date with sentiment

**Key Insights**

• Notable surprises or misses
• Sectors with heavy reporting
• Estimate revision trends

> This is not financial advice. Data is for informational purposes only.

Endpoints Used

| Endpoint | Purpose | Cost | |----------|---------|------| | `calendar/earnings` | Earnings dates and estimates | 1 call | | `calendar/trends` | EPS/revenue trends and revisions | 1 call | | `news` | Earnings-related news | 5 + 5/ticker | | `eod` | Price around earnings | 1 call | | `intraday` | Intraday reaction | 5 calls |

References

• `../eodhd-api/references/endpoints/upcoming-earnings.md`
• `../eodhd-api/references/endpoints/earnings-trends.md`
• `../eodhd-api/references/endpoints/company-news.md`
• `../eodhd-api/references/endpoints/intraday-historical-data.md`