bigdata_events_calendar

Returns the corporate earnings calendar and conference call schedule.

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 to find_securities 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_securities.
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