Skill: khaney64/market-events (version 0.1.4)

--- name: market-events description: > Reports upcoming or recent earnings, dividends, and stock splits from FMP for a watchlist of tickers. Accepts a comma-separated ticker list or a file of tickers. Returns events in a given date range (default 7 days ahead; use negative range like -30d to look back). Use when the user asks about upcoming or past corporate events, earnings dates, dividend schedules, or stock splits for specific tickers. metadata: {"openclaw":{"emoji":"📅","requires":{"bins":["python3"],"env":["FMP_API_KEY"]}}} --- # Market Events Query the Financial Modeling Prep (FMP) API to report upcoming or recent earnings, dividends, and stock splits for a watchlist of tickers. ## Quick Start ```bash # Check events for specific tickers (next 7 days) python3 /home/claw/.openclaw/workspace/skills/market-events/market-events.py --tickers AAPL,MSFT,GOOG # Use a ticker file python3 /home/claw/.openclaw/workspace/skills/market-events/market-events.py --file tickers.txt # Combine both, custom range, specific event types python3 /home/claw/.openclaw/workspace/skills/market-events/market-events.py --tickers NVDA --file watchlist.csv --range 14d --types earnings,dividends # Check past dividends (last 30 days) python3 /home/claw/.openclaw/workspace/skills/market-events/market-events.py --tickers AAPL --range -30d --types dividends ``` ## Usage ``` python3 /home/claw/.openclaw/workspace/skills/market-events/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/lookback window. Units: d/w/y. Negative = look back. Examples: 7d, 2w, -30d, -1y. Default: 7d. Max: 365d/52w/1y. --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`) ```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).


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)