bigdata_events_calendar

Returns either the corporate events calendar - earnings, conferences, IPO listings and delistings - or the economic calendar of macroeconomic releases.

Overview

This tool serves two different calendars, and calendar_type picks between them.

• corporate_calendar - corporate events: earnings announcements, investor conferences, IPO listings and delistings, across thousands of companies in global markets. Filter by company, date range, country, exchange or industry sector.
• economic_calendar - macroeconomic releases: inflation prints, employment figures, growth, and central bank decisions, by country. Filter by date range, country, category or expected market impact.

calendar_type is required. There is no default, because which calendar answers a question is a decision only the caller can make.

When to Use

Use calendar_type: "corporate_calendar" 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
• See which companies are about to list, or have recently been delisted

Use calendar_type: "economic_calendar" when you need to:

• Find out when the next inflation or employment figure is published
• See what economic data is due this week for one country or several
• Track central bank meetings and interest rate decisions
• Compare what a release was expected to be against what it came in at
• Narrow a busy week down to the releases that move markets

The question tells you which: a company, ticker or portfolio means the corporate calendar, while an economy, a country or a named indicator such as CPI, payrolls or GDP means the economic one.

For the broader state of one country’s economy - its market indices, currency, bond yields and G7 comparison - use bigdata_country_tearsheet instead. This tool answers a schedule of releases.

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.

For the economic calendar there is no company lookup and no display mode to choose: releases are returned for the countries requested, split into what has already been published and what is still to come.

Parameters

The tool takes a single filters object. calendar_type inside it picks the calendar, and the rest of the object is that calendar’s own filters.

{ "filters": { "calendar_type": "corporate_calendar", "rp_entity_ids": ["D8442A"] } }

{ "filters": { "calendar_type": "economic_calendar", "countries": ["US", "EMU"], "impacts": ["HIGH"] } }

Both calendars

Field of filters	Type	Required	Description
calendar_type	string	Yes	Which calendar to return: "corporate_calendar" or "economic_calendar".
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.

Corporate events only

Valid when calendar_type is "corporate_calendar".

Field of filters	Type	Required	Description
rp_entity_ids	array of strings	No	List of 6-character RavenPack Entity IDs for specific companies. Obtained via find_securities.
categories	array	No	Filter by event type: "earnings-call", "conference-call", "ipos-calendar", "delisted-company". Returns every category 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.

Economic calendar only

Valid when calendar_type is "economic_calendar".

Field of filters	Type	Required	Description
countries	array	No	Countries whose releases to return, as ISO 2-letter codes plus "EMU" for the euro area. Returns every country covered if omitted.
categories	array	No	Filter by the kind of indicator, e.g. "inflation", "labor-market", "central-banks". Returns every category if omitted.
impacts	array	No	Filter by expected market impact: "HIGH", "MEDIUM", "LOW", "NONE". Returns every level if omitted.

A filter belonging to the other calendar is rejected rather than ignored, so the two sets cannot be mixed in one call. Ask twice when both calendars are wanted.

countries and categories appear on both calendars and mean different things on each. On the corporate calendar countries is where a company is headquartered; on the economic one it is where a figure is published, and only that list carries "EMU" for the euro area, where ECB decisions and euro-area aggregates appear. "UK" is accepted there for Great Britain and answered as "GB". Each accepts only its own calendar’s values, so a euro-area code sent to the corporate calendar is rejected.

Both calendars name their categories the same way, in lower case with hyphens between the words — "earnings-call" on one, "labor-market" on the other. Spell one exactly as it is listed: "Labor Market" and "labor_market" are rejected, not folded onto "labor-market". A release answers "labor-market".

The economic calendar has no pagination, so limit and cursor do not apply to it. Narrow a wide window by date, country or impact instead.

Data Returned

Results are returned as a formatted markdown calendar.

Corporate events

A section appears only when the results contain events of that kind:

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”)

IPOs Section

A table of US initial public offerings, upcoming and recently priced, including:

• Ticker - the ticker the company will list under
• Company Name - the name as the offering reports it
• Listing Date - the date of the listing. There is no time column: an offering is dated to the day
• Name - the offering, with its status as a prefix (“Priced:”, “Expected:”, “Withdrawn:“)

Delistings Section

A table of companies removed from an exchange, covering 2025-01-01 onwards, including:

• Ticker - the ticker the company traded under
• Company Name - the name as the source reports it
• Delisting Date - the date of the delisting, dated to the day like an IPO listing
• Name - the delisting, naming the company and the exchange it left

Every delisting is in the past, so a forward-looking date range returns none of them. Ask with a range that reaches back, for example “which companies were delisted last month”.

A company that has not started trading yet, or was never mapped to an entity record, still appears: those rows are grouped under the single entity ID NO_MAP, identified by their ticker and company name. Treat them as real results, and never pass NO_MAP back as an rp_entity_id, since it is a bucket holding several companies rather than one entity.

Economic releases

The economic calendar is split into what has already been published and what is still to come. Each section groups its releases by country, under a heading naming the country - or the euro area, where ECB decisions and euro-area aggregates are published.

Both tables share four columns:

• Date (UTC) - when the figure is released
• Indicator - the name of the release, for example “Nonfarm Payrolls” or “Core CPI (YoY)”. A speech or a report is marked as such, and a first estimate is marked “(Preliminary)”
• Period - the month or quarter the figure describes, which is not when it was released: a December CPI published in January describes December
• Impact - how much market movement the release is expected to cause

The released table then carries what was published against what was expected:

• Actual - the figure that was published
• Consensus - what the market expected
• Previous - the prior period’s figure
• Surprise - how far the two landed apart, signed

The upcoming table carries Consensus and Previous only. A release that has not happened has no Actual and no Surprise, so those columns are absent rather than empty.

Figures are shown with their magnitude and unit applied, so 250K means 250,000 and 3.5% is a rate.

Surprise carries its own unit, and the two are not the same measurement.

An indicator already published as a percentage - a CPI rate, a GDP growth rate, a policy rate - is compared by subtraction, so its surprise is in percentage points and reads +0.10pp. Every other indicator, such as a payroll count or a trade balance, is compared relatively, as a percentage of the consensus, and reads +25.00%.

The reason is that dividing one percentage by another measures the size of the consensus rather than the release: core CPI at 0.3% against a 0.2% consensus missed by a tenth of a point, not by 50%. Read the suffix before comparing two surprises against each other.

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.

Macro Week Ahead

Ask for the economic calendar over the coming week at "HIGH" impact to get the releases that move markets, without the long tail of minor indicators.

Release Tracking

Look up when a specific indicator is next published - the next US CPI print, the next euro-area rate decision - and see what the market expects before it lands.

Surprise Analysis

Ask for a window that has already passed to compare Actual against Consensus across a set of countries, and see which economies came in ahead of or behind expectations. The Surprise column states the gap directly - in percentage points for a rate, as a percentage of the consensus for anything else.

Event Categories

Corporate events, passed in categories when calendar_type is "corporate_calendar":

Category	Description
earnings-call	Quarterly or annual earnings announcements with scheduled call times
conference-call	Investor conferences, analyst days, AGMs, and other corporate presentations
ipos-calendar	US initial public offerings, upcoming and recently priced
delisted-company	US companies removed from an exchange, from 2025-01-01 onwards

Economic Categories

Passed in categories when calendar_type is "economic_calendar":

Category	Description
bond-auctions	Government debt auctions
capital-flows	Trade balance, current account, foreign investment
central-banks	Rate decisions, minutes, speeches by central bank officials
consumption	Retail sales, consumer spending, consumer confidence
economic-activity	GDP, industrial production, PMI surveys
energy	Oil and gas inventories, energy production
holidays	Market holidays, when exchanges are closed
housing-market	Housing starts, building permits, home sales and prices
inflation	CPI, PPI, HICP and other price indices
interest-rates	Policy rates and rate expectations
labor-market	Payrolls, unemployment rate, jobless claims, wages
politics	Elections, budgets, fiscal announcements