Material Corporate Events (Historical) Formula in Excel
Discover how to leverage the powerful MarketXLS “Material Corporate Events (Historical)” formula to retrieve important historical corporate event details—such as mergers, acquisitions, and major restructuring—directly in Excel. This function streamlines fundamental data analysis and supports better decision-making in your investment research.
Understanding Material Corporate Events (Historical)
Material Corporate Events (Historical) is a specialized MarketXLS function designed to:
- Return key information regarding corporate events that significantly impact a company’s business operations and ownership structure.
- Provide historical data over specified time periods (by year or quarter, including trailing-twelve-month aggregations).
- Help investors and analysts spot major transactions (e.g., mergers, consolidations, spin-offs) that may influence a company’s financial position.
Key benefits:
- Simplifies fundamental research workflows by bringing corporate event data directly into Excel.
- Saves time by eliminating the need to manually search corporate filings or multiple sources for historical event information.
- Ideal for analysts, portfolio managers, and individual investors monitoring corporate actions.
Syntax and Parameters
Use the hf_Material_Corporate_Events
function to retrieve historical corporate event data for a given symbol and period.
=hf_Material_Corporate_Events(Symbol, Year, [Quarter], [TTM])
Parameter | Description | Required | Example |
---|---|---|---|
Symbol | The ticker symbol or identifier for the security (stocks, indices, crypto, options). | Yes | "MSFT", "^SPX", "BTCUSD:DEFAULT" |
Year | The year you want to reference. Accepts specific years (e.g., "2022") or dynamic references like "ly" (last year), "lq" (last quarter), etc. | Yes | "2022", "ly", "lq-1" |
Quarter | The specific calendar quarter (1, 2, 3, or 4). If left blank, defaults to 1. | No | 1, 2, 3, or 4 |
TTM | Use "TTM" to pull trailing twelve months data. Leave blank if not needed. | No | "TTM" |
Return Value:
• Typically returns a numerical value if the historical corporate event data is quantifiable.
• May return a text string or “NA” if data is not available or an error occurs.
?? Note: This function requires a valid subscription to historical fundamental data via MarketXLS. If your license is not active or data is unavailable, the function will return "NA".
Examples and Usage
Below are various ways to use the Material Corporate Events (Historical) function in Excel with MarketXLS.
-
Basic Examples
- Retrieve the corporate events value for Microsoft (MSFT) for year 2022:
=hf_Material_Corporate_Events("MSFT", "2022")
- For the second quarter of 2022:
=hf_Material_Corporate_Events("MSFT", "2022", 2)
- For trailing twelve months (TTM) from the third quarter of 2022:
=hf_Material_Corporate_Events("MSFT", "2022", 3, "TTM")
- Retrieve the corporate events value for Microsoft (MSFT) for year 2022:
-
Dynamic References (Last Quarter, Last Year, etc.)
- Last quarter (lq):
=hf_Material_Corporate_Events("MSFT", "lq")
- Last quarter minus one (lq-1):
=hf_Material_Corporate_Events("MSFT", "lq-1")
- Last year (ly):
=hf_Material_Corporate_Events("MSFT", "ly")
- Last 12 months (lt):
=hf_Material_Corporate_Events("MSFT", "lt")
- Last quarter (lq):
-
Symbol Variations
- Indices:
=hf_Material_Corporate_Events("^SPX", "2022")
- Crypto:
=hf_Material_Corporate_Events("BTCUSD:DEFAULT", "2022")
- Options Format:
=hf_Material_Corporate_Events("@MSFT 110122C00020000", "2022")
- Indices:
-
Date Inputs (Alternate Approaches)
Though typically this function uses a “Year/Quarter” approach, if you store date references for your analysis or want to maintain consistent date handling, consider the following patterns:
- Using a cell reference (e.g., A1 contains "2024-03-15"):
=hf_Material_Corporate_Events(A1, "2024")
- Entering a direct date string (not typical for this function, but possible if integrated with other date handling):
=hf_Material_Corporate_Events("MSFT", "2024-03-15")
- Using Excel date functions:
=hf_Material_Corporate_Events("MSFT", TEXT(A1,"yyyy-mm-dd"))
- Using a cell reference (e.g., A1 contains "2024-03-15"):
? Pro Tip: Combine
hf_Material_Corporate_Events
with other historical fundamental functions (e.g.,hf_Revenue
) to build complete financial models in Excel.
Common Questions
-
Why am I getting “NA” as a result?
- “NA” indicates data is not available for the requested symbol or period. It may also mean your license subscription for the MarketXLS historical fundamentals is inactive.
-
How do I improve performance when pulling these values repeatedly?
- Use Excel’s built-in features—like calculation options and limiting recalculation—to optimize performance when working with many function calls.
-
Can I use this function for international symbols?
- Yes, if MarketXLS covers those symbols. For unsupported international listings, the function returns “NA.”
-
Does this function handle partial-year or partial-quarter data?
- The function focuses on full-year, quarter, or trailing-twelve-month data. If partial data is unavailable, you might see “NA” or an incomplete value.
-
Are there any special limitations?
- You must maintain an active MarketXLS subscription with historical fundamentals access. Certain data points for less common symbols may be delayed in the database.
By integrating the Material Corporate Events (Historical) function into your Excel workflow, you can quickly and accurately research significant past corporate actions, helping you make more informed decisions about your investments.