Earnings Calendar

A straightforward wrapper around yfinance for pulling earnings dates, timing, and EPS estimates. You pass in one or more ticker symbols and get back when they're reporting next, whether it's before or after the bell, and what analysts expect for EPS. The multi-symbol output sorts by date, which is actually useful if you're managing a portfolio and want to see which positions have earnings risk coming up first. It's basic fundamental data, nothing fancy, but it beats manually looking up earnings calendars when you need to check if your holdings are about to report. Works well for planning around volatility or just staying aware of what's on deck.

GitHub stars: 248
last updated: Jun 11, 2026

View on GitHub

Install

$ npx -y skills add staskh/trading_skills --skill earnings-calendar --agent claude-code

Installs into .claude/skills of the current project.

Files

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.

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

# 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