---
name: staskh-earnings-calendar
description: "Get upcoming earnings dates with timing (before/after market) and EPS estimates. Use when user asks about earnings dates, earnings calendar, when a company reports, or upcoming earnings."
license: "MIT"
metadata:
  decimalai-skill-id: "d456bb7b-2308-4383-a1de-9b30f5d72a6b"
  decimalai-version-id: "37b86704-0b94-413e-8aa0-f614238f21b1"
  decimalai-version: "1"
  decimalai-body-sha256: "ee5e2953eff12f03057488f12b56f05ae9828730c8c93fd0d7f704aa1be538af"
  decimalai-name: "staskh/earnings-calendar"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "finance"
  decimalai-source: "https://app.decimal.ai/s/staskh-earnings-calendar@1/SKILL.md"
---
# Earnings Calendar

Retrieve upcoming earnings dates for stocks.

## Instructions

> **Note:** If `uv` is not installed or `pyproject.toml` is not found, replace `uv run python` with `python` in all commands below.

```bash
uv run python scripts/earnings.py SYMBOLS
```

## Arguments

- `SYMBOLS` - Ticker symbol or comma-separated list (e.g., `AAPL` or `AAPL,MSFT,GOOGL,NVDA`)

## Output

Single symbol returns:
- `symbol` - Ticker symbol
- `earnings_date` - Next earnings date (YYYY-MM-DD)
- `timing` - "BMO" (Before Market Open), "AMC" (After Market Close), or null
- `eps_estimate` - Consensus EPS estimate, or null if unavailable

Multiple symbols returns:
- `results` - Array of earnings info, sorted by date (soonest first)

## Examples

```bash
# Single symbol
uv run python scripts/earnings.py NVDA

# Multiple symbols (sorted by date)
uv run python scripts/earnings.py AAPL,MSFT,GOOGL,NVDA,META

# Portfolio earnings calendar
uv run python scripts/earnings.py CAT,GOOG,HOOD,IWM,NVDA,PLTR,QQQ,UNH
```

## Use Cases

- Check when positions have upcoming earnings risk
- Plan trades around earnings announcements
- Build an earnings calendar for watchlist

## Dependencies

- `pandas`
- `yfinance`


## Timezone

All timestamps and time-based calculations must use the `America/New_York` timezone. All JSON output must include `generated_at` (NY time string) and `data_delay` fields.