Treasury Stock (Historical) Formula in Excel
Discover how to use the Treasury Stock (Historical) formula in Excel with MarketXLS to retrieve the value of treasury shares a company has repurchased over specific historical periods. This function is particularly useful for financial analysts, investors, and anyone interested in fundamental stock data for better decision-making.
Understanding Treasury Stock (Historical)
Treasury Stock (Historical) provides insight into the portion of shares a company has bought back from investors. These repurchased shares are often held in the company's treasury and can influence key metrics like earnings per share (EPS) and dividends per share.
- Purpose: To obtain historical treasury stock data for a given symbol and time period.
- Key Benefits:
- Helps assess how share buybacks affect EPS.
- Useful for valuation models and understanding shareholder returns.
- When to Use:
- Analyzing a company’s capital structure changes over time.
- Conducting thorough fundamental analysis.
Syntax and Parameters
Use the following syntax to call the function in Excel:
=hf_Treasury_Stock(Symbol, year, [quarter], [TTM])
Parameter | Description | Required | Example |
---|---|---|---|
Symbol | The ticker or identifier of the security. Supports equities (e.g., "MSFT"), indices (e.g., "^SPX"), options (e.g., "@MSFT 110122C00020000"), and crypto (e.g., "BTCUSD:DEFAULT"). | Yes | "MSFT" |
year | The year or relative time reference for the data. Can be a specific year (e.g., "2023") or "ly", "ly-1", "lq", "lq-1", "lt", "lt-1". | Yes | "2023" or "lq-1" |
quarter | The calendar quarter to retrieve data for (1, 2, 3, or 4). Default is "1" if not specified. | No | "2" |
TTM | If set to "TTM", returns trailing twelve months data. Can be left blank if not needed. | No | "TTM" |
?? Note: If the symbol is invalid or your MarketXLS license does not cover the function, the formula returns "NA."
Return Value
• Returns a numeric value that indicates the amount of treasury stock held (historical).
• Returns "NA" if data is unavailable or if there is an error.
Examples and Usage
Below are practical examples demonstrating how to use the Treasury Stock (Historical) formula:
-
Basic retrieval for a specific year:
=hf_Treasury_Stock("MSFT", 2022)
Retrieves the treasury stock value for MSFT in 2022.
-
Specifying a quarter:
=hf_Treasury_Stock("MSFT", 2022, 3)
Retrieves the treasury stock value for MSFT in the third quarter of 2022.
-
Using trailing twelve months (TTM):
=hf_Treasury_Stock("MSFT", 2022, 3, "TTM")
Retrieves the trailing twelve months treasury stock value from the third quarter of 2022.
-
Using relative references (last quarter):
=hf_Treasury_Stock("MSFT","lq")
Retrieves the treasury stock value for the last reported quarter.
? Pro Tip: When using relative references like "lq-1" or "ly-1," you can easily track changes in treasury stock from previous periods without manually updating year or quarter values.
Common Questions
-
What happens if I use an invalid symbol?
You will receive "NA" as the result. Double-check your ticker or upgrade your license if needed. -
How do I handle errors or missing data?
The formula returns "NA" if data is missing or an error occurs during processing. Verify your parameters or contact MarketXLS support. -
Are there any performance considerations?
The function retrieves data from external MarketXLS APIs. Performance depends on your internet connection and the MarketXLS data server load. -
Can I use date references directly?
This function typically requires a year (or a relative reference). For date-based queries, consider using:
• Cell references: =hf_Treasury_Stock(A1)
• Direct date calls (converted to year or relative reference): =hf_Treasury_Stock(TEXT(A1,"yyyy"))
Use the Treasury Stock (Historical) formula in Excel with MarketXLS to gain quick insights into a company’s share repurchases and enhance your fundamental analysis. Keep these guidelines in mind, and always verify your data to ensure accurate results.