Overview
The Events Calendar provides a professionally formatted calendar of corporate events, including earnings announcements and investor conferences. It covers thousands of companies across global markets and can be filtered by company, date range, country, exchange, or industry sector - making it easy to stay on top of market-moving events.When to Use
The Events Calendar is the right tool when you need to:- Find out when a specific company is reporting earnings
- Browse upcoming earnings across a market, sector, or exchange
- Discover investor days, AGMs, and analyst conferences
- Build a schedule of events for a portfolio of companies
- Track earnings across a specific date range or region
How It Works
When a query is made to the Events Calendar, the tool retrieves and formats relevant corporate events based on the filters provided. For queries targeting specific companies, a call is first made tofind_companies to resolve the company name or ticker into a RavenPack Entity ID - this ID is then passed to the Events Calendar to retrieve that company’s events.
For market-wide or sector-wide queries, no company lookup is needed - filters like country, exchange, or sector are used directly to scope the results.
The tool automatically selects the most appropriate display mode:
- Calendar Mode - used for multi-company, market-wide, or filtered queries. Events are displayed chronologically across all matching companies.
- Company Mode - used for single-company queries. Events are grouped per company for a cleaner view.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
rp_entity_ids | array of strings | No | List of 6-character RavenPack Entity IDs for specific companies. Obtained via find_companies. |
start_date | string (YYYY-MM-DD) | No | Start of the date range. Defaults to today if not provided. |
end_date | string (YYYY-MM-DD) | No | End of the date range. Defaults to 7 days after start_date if not provided. |
categories | array | No | Filter by event type: "earnings-call" and/or "conference-call". Returns both if omitted. |
countries | array | No | Filter by company headquarters country using ISO 2-letter codes (e.g., "US", "DE", "JP"). |
exchanges | array | No | Filter by stock exchange using MIC codes (e.g., "XNYS" for NYSE, "XNGS" for Nasdaq). |
sectors | array | No | Filter by industry sector (e.g., "Technology", "Health Care", "Financials"). |
limit | integer | No | Maximum number of events to return per page (1–500, default 100). |
cursor | string | No | Pagination cursor for retrieving the next page of results. |
Data Returned
Results are returned as a formatted markdown calendar with two sections:Earnings Section
A table of upcoming or recent earnings announcements, including:- Ticker - the company’s stock ticker symbol
- Company Name - full legal name
- Release Date - the date of the earnings announcement
- Earnings Call Time - time of the earnings call in UTC
- Period - the fiscal period being reported (e.g., Q1, Q2, Q3, Q4, H1, H2)
Conferences Section
A table of investor-facing events, including:- Ticker - the company’s stock ticker symbol
- Company Name - full legal name
- Date - date of the event
- Time - time of the event in UTC
- Name - the event name (e.g., “Investor Day 2026”, “AGM 2026”, “Morgan Stanley Technology Conference”)
Use Cases
Earnings Research
Look up the exact date and time a company is scheduled to report earnings - useful for planning analysis, trade timing, or preparing questions for an earnings call.Portfolio Monitoring
Retrieve the earnings calendar for a portfolio of companies over a specific date range to stay ahead of reporting season and anticipate volatility.Sector Screening
Filter by sector (e.g., Technology, Health Care) to see all upcoming earnings or conferences across an industry - useful for thematic research or competitive analysis.Regional Market Coverage
Use country or exchange filters to scope the calendar to a specific market, such as all US-listed companies reporting on NYSE next week, or all UK companies reporting this month.Conference Discovery
Find upcoming investor days and analyst conferences for companies of interest - helpful for tracking management commentary and forward guidance outside of earnings season.Earnings Season Planning
Use broad date range + sector/country filters to get a full picture of an earnings season, and use pagination to work through large result sets.Event Categories
| Category | Description |
|---|---|
earnings-call | Quarterly or annual earnings announcements with scheduled call times |
conference-call | Investor conferences, analyst days, AGMs, and other corporate presentations |