This skill retrieves upcoming earnings announcements for US stocks using the Financial Modeling Prep (FMP) API. Use this when the user requests earnings calendar data, wants to know which companies are reporting earnings in the upcoming week, or needs a weekly earnings review. The skill focuses on mid-cap and above companies (over $2B market cap) that have significant market impact, organizing the data by date and timing in a clean markdown table format. Supports multiple environments (CLI, Desktop, Web) with flexible API key management.
84%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
This skill retrieves upcoming earnings announcements for US stocks using the Financial Modeling Prep (FMP) API. It focuses on companies with significant market capitalization (mid-cap and above, over $2B) that are likely to impact market movements. The skill generates organized markdown reports showing which companies are reporting earnings over the next week, grouped by date and timing (before market open, after market close, or time not announced).
Key Features:
This skill requires a Financial Modeling Prep API key.
Get Free API Key:
API Key Setup by Environment:
Claude Code (CLI):
export FMP_API_KEY="your-api-key-here"Claude Desktop: Set environment variable in system or configure MCP server.
Claude Web: API key will be requested during skill execution (stored only for current session).
CRITICAL: Always start by obtaining the accurate current date.
Retrieve the current date and time:
Date Range Calculation:
Current Date: [e.g., November 2, 2025]
Target Week Start: [Current Date + 1 day, e.g., November 3, 2025]
Target Week End: [Current Date + 7 days, e.g., November 9, 2025]Why This Matters:
Format dates in YYYY-MM-DD for API compatibility.
Before retrieving data, load the comprehensive FMP API guide:
Read: references/fmp_api_guide.mdThis guide contains:
Detect API key availability based on environment.
Multi-Environment API Key Detection: Read references/api_key_setup_flow.md when no FMP_API_KEY environment variable is found. It holds the environment check, the AskUserQuestion prompt, the free-key instructions and the session-only key handling.
Use the Python script to fetch earnings data from FMP API.
Script Location:
scripts/fetch_earnings_fmp.pyExecution:
Option A: With Environment Variable (CLI):
python scripts/fetch_earnings_fmp.py 2025-11-03 2025-11-09Option B: With Session API Key (Desktop/Web):
python scripts/fetch_earnings_fmp.py 2025-11-03 2025-11-09 "${API_KEY}"Script Workflow (automatic):
Expected Output Format (JSON):
[
{
"symbol": "AAPL",
"companyName": "Apple Inc.",
"date": "2025-11-04",
"timing": "AMC",
"marketCap": 3000000000000,
"marketCapFormatted": "$3.0T",
"sector": "Technology",
"industry": "Consumer Electronics",
"epsEstimated": 1.54,
"revenueEstimated": 123400000000,
"fiscalDateEnding": "2025-09-30",
"exchange": "NASDAQ"
},
...
]Save to file (recommended for use with report generator):
python scripts/fetch_earnings_fmp.py 2025-11-03 2025-11-09 "${API_KEY}" > earnings_data.jsonOr capture to variable:
earnings_data=$(python scripts/fetch_earnings_fmp.py 2025-11-03 2025-11-09 "${API_KEY}")Error Handling:
If script returns errors:
Once earnings data is retrieved (JSON format), process and organize it: Read references/data_processing_steps.md when parsing and organizing the fetched earnings JSON (steps 5.1 to 5.6).
Use the report generation script to create a formatted markdown report from the JSON data.
Script Location:
scripts/generate_report.pyExecution:
Option A: Output to stdout:
python scripts/generate_report.py earnings_data.jsonOption B: Save to file:
python scripts/generate_report.py earnings_data.json earnings_calendar_2025-11-02.mdWhat the script does:
The script automatically handles all formatting including:
Report Structure: Read references/report_template.md for the full markdown report structure.
Formatting Best Practices:
Before finalizing the report, verify:
Data Quality Checks:
Completeness Checks:
Format Checks:
Save the generated report with an appropriate filename:
Filename Convention:
earnings_calendar_[YYYY-MM-DD].mdExample: earnings_calendar_2025-11-02.md
The filename date represents the report generation date, not the earnings week.
Delivery:
Example Summary:
✓ Earnings calendar report generated: earnings_calendar_2025-11-02.md
Summary for week of November 3-9, 2025:
- 45 companies reporting earnings
- 28 large/mega-cap, 17 mid-cap
- Peak day: Thursday (15 companies)
- Notable: Apple (Mon AMC), Microsoft (Tue AMC), Tesla (Wed AMC)
Top 5 by market cap:
1. Apple - $3.0T (Mon AMC)
2. Microsoft - $2.8T (Tue AMC)
3. Alphabet - $1.8T (Thu AMC)
4. Amazon - $1.6T (Fri AMC)
5. Tesla - $800B (Wed AMC)If API access is unavailable or user chooses to skip API:
Provide Instructions for Manual Entry:
Since FMP API is not available, you can manually gather earnings data:
1. Visit Finviz: https://finviz.com/screener.ashx?v=111&f=cap_midover%2Cearningsdate_nextweek
2. Or Yahoo Finance: https://finance.yahoo.com/calendar/earnings
3. Note down companies reporting next week
Please provide the following information for each company:
- Ticker symbol
- Company name
- Earnings date
- Timing (BMO/AMC/TAS)
- Market cap (approximate)
- Sector
I will format this into the standard earnings calendar report.Process Manual Input:
Read references/use_cases.md for four worked use cases: weekly review, a specific day, mega-cap focus, sector focus.
Solutions:
Solutions:
Solutions:
Solutions:
Solutions:
python3 --versionpip install -r skills/earnings-calendar/requirements.txt (a missing requests makes the script print "ERROR: requests library not found" to stderr and exit with status 2, with the full requirements.txt path in the message)chmod +x fetch_earnings_fmp.pypython3 fetch_earnings_fmp.py ...Read references/best_practices_and_security.md (section "Best Practices") for the Do's and Don'ts list.
Read references/best_practices_and_security.md (section "Security Notes: API Key Security") for API key handling guidance per environment.
Read references/resource_links.md for FMP documentation links, supplementary sources and the skill resource list.
This skill provides a reliable, API-driven approach to generating weekly earnings calendars for US stocks. By using FMP API, it ensures structured, accurate data with additional insights like EPS/revenue estimates. The multi-environment support makes it flexible for CLI, Desktop, and Web usage, while the fallback mode ensures functionality even without API access.
Key Workflow: Date Calculation → API Key Setup → API Data Retrieval → Processing → Report Generation → QA → Delivery
Output: Clean, organized markdown report with earnings grouped by date/timing/market cap, including summary statistics and trading considerations.
tradermonty/claude-trading-skills
a627d17
Also appears in
last in sync Sep 24, 2026
last in sync Sep 24, 2026
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.