Market Events

Query the Financial Modeling Prep (FMP) API to report upcoming earnings, dividends, and stock splits for a watchlist of tickers.

Quick Start

# Set your FMP API key
export FMP_API_KEY="your_api_key"

# Check events for specific tickers (next 7 days)
python market-events.py --tickers AAPL,MSFT,GOOG

# Use a ticker file
python market-events.py --file tickers.txt

# Combine both, custom range, specific event types
python market-events.py --tickers NVDA --file watchlist.csv --range 14d --types earnings,dividends

Usage

python market-events.py [OPTIONS]

Options:
  --tickers TICKERS   Comma-separated list of ticker symbols
  --file PATH         Path to a .txt or .csv file of tickers
  --range RANGE       Lookahead window (e.g. 7d, 14d, 30d). Default: 7d. Max: 90d.
  --format FORMAT     Output format: text, json, or discord. Default: text.
  --types TYPES       Comma-separated event types: earnings,dividends,splits. Default: all.
  -h, --help          Show help message

At least one of --tickers or --file must be provided.

Ticker File Formats

Plain text (.txt)

AAPL
MSFT
# This is a comment
GOOG

CSV (.csv)

First column is used as ticker. Header row is auto-detected and skipped.

ticker,name
AAPL,Apple Inc
MSFT,Microsoft Corp

Output Formats

Text (default)

Market Events: 2026-03-16 → 2026-03-23 (3 tickers, earnings/dividends/splits)
──────────────────────────────────────────────────────────────────────
Date        Ticker  Type       Detail
2026-03-18  AAPL    earnings   EPS est: 1.52  Revenue est: 94.36B
2026-03-20  MSFT    dividends  Dividend: 0.75  Ex-date: 2026-03-20  Pay date: 2026-04-10
──────────────────────────────────────────────────────────────────────
2 events found.

JSON (--format json)

{
  "range": {"from": "2026-03-16", "to": "2026-03-23"},
  "ticker_count": 3,
  "types": ["earnings", "dividends", "splits"],
  "event_count": 2,
  "events": [
    {"date": "2026-03-18", "ticker": "AAPL", "event_type": "earnings", "detail": "EPS est: 1.52  Revenue est: 94.36B", "raw": { ... }},
    {"date": "2026-03-20", "ticker": "MSFT", "event_type": "dividends", "detail": "Dividend: 0.75  Ex-date: 2026-03-20", "raw": { ... }}
  ]
}

The raw field contains the full FMP API response for each event.

Discord (--format discord)

**Market Events** 2026-03-16 → 2026-03-23 (3 tickers, earnings/dividends/splits)
💰 **AAPL** 2026-03-18 — EPS est: 1.52  Revenue est: 94.36B
💵 **MSFT** 2026-03-20 — Dividend: 0.75  Ex-date: 2026-03-20  Pay date: 2026-04-10
_2 events found._

Notes

• Requires the requests library (pip install requests).
• FMP free tier has rate limits. The skill handles 429 responses with a warning and continues with partial results.
• Events are sorted by date ascending, then by event type (earnings → dividends → splits).