Price cash indicator (Historical) Formula in Excel

Welcome to this comprehensive guide on using the Price cash indicator (Historical) formula in Excel with MarketXLS. This function allows you to retrieve historical price-cash indicators, empowering you to analyze company cash data in relation to its share price, identify trends, and make informed decisions.

Understanding Price cash indicator (Historical)

The Price cash indicator (Historical) helps you:

  • Compare a company’s historical share price to its cash figures.
  • Discover trends in price-cash ratios over various quarters or years.
  • Evaluate growth or decline in cash-based indicators for more precise financial analysis.

You would use this function:

  • When performing fundamental financial analysis over multiple periods.
  • To quickly spot changes in a company’s price-cash ratio.
  • For building dashboards that need historical price and cash comparisons.

Syntax and Parameters

The syntax for using the hf_Price_Cash_Indicator function in Excel is:

=hf_Price_Cash_Indicator(symbol, year, [quarter], [TTM])
Parameter Description Required Example
symbol The ticker symbol or identifier of the security. Can be an equity, index, option, or cryptocurrency symbol. Yes "MSFT", "^SPX", "@MSFT 110122C00020000", "BTCUSD:DEFAULT"
year The calendar or relative year you want to retrieve the data for. Accepts “2022”, “ly” (last year), “ly-1”, etc. Yes "2022", "ly", "ly-1"
quarter The calendar quarter (1 to 4). Defaults to "1" if omitted. Also accepts “lq” (last quarter), “lq-1”, etc. No "2"
TTM Trailing Twelve Months indicator. Enter "TTM" to retrieve TTM values (optional). No "TTM"

?? Note:
• A valid MarketXLS subscription is required—otherwise, the function returns "NA".
• The function generally returns a numeric value, or "NA" if data is unavailable or an error occurs.

Special Conventions for Symbols and Dates

  • Regular symbols:
    =hf_Price_Cash_Indicator("MSFT", "2022")
  • Index symbols:
    =hf_Price_Cash_Indicator("^SPX", "2022")
  • Option symbols:
    =hf_Price_Cash_Indicator("@MSFT 110122C00020000", "2023")
  • Cryptocurrency symbols:
    =hf_Price_Cash_Indicator("BTCUSD:DEFAULT", "2022")

Although this function focuses on years, if you reference dates in your worksheet, you could adapt them as text inputs:

  1. Cell references:
    =hf_Price_Cash_Indicator("MSFT", A1)
  2. Direct text dates (converted to year strings):
    =hf_Price_Cash_Indicator("MSFT", "2024")
  3. Using Excel functions to format dates into the year:
    =hf_Price_Cash_Indicator("MSFT", TEXT(A1,"yyyy"))

Examples and Usage

Below are a few practical use cases to illustrate how you might use the hf_Price_Cash_Indicator function in your Excel worksheets:

  1. Retrieve historical data for a specific year:

    =hf_Price_Cash_Indicator("MSFT", 2022)

    This returns the price-cash indicator for Microsoft in 2022.

  2. Specify the exact quarter:

    =hf_Price_Cash_Indicator("MSFT", 2022, 2)

    This retrieves the Q2 2022 historical price-cash indicator for Microsoft.

  3. Include the trailing twelve months (TTM):

    =hf_Price_Cash_Indicator("MSFT", 2022, 3, "TTM")

    This retrieves the TTM value from Q3 2022.

  4. Relative periods such as last quarter or last year:

    =hf_Price_Cash_Indicator("MSFT", "lq")
    =hf_Price_Cash_Indicator("MSFT", "ly")

    These return the most recent quarter or the last year automatically.

? Pro Tip: Combine hf_Price_Cash_Indicator with other MarketXLS historical functions (e.g., hf_Revenue, hf_Gross_Profit) for a deeper comparative analysis.

Common Questions

1. Why am I getting "NA"?

  • Ensure your MarketXLS license is valid.
  • Check that the symbol or year parameter is correct.
  • Data might be unavailable for the requested period.

2. Can I use custom date formats?

  • Yes, but since year is the main parameter, convert your date into a year string using TEXT(A1,"yyyy").

3. How often is the data updated?

  • MarketXLS updates historical fundamental data regularly. Updates can vary by symbol type and data availability.

4. Does it work for all symbols worldwide?

  • The function works for most US-based symbols, select indices, options, and some crypto. Additional international coverage may vary.

?? Note: If you need further historical metrics—like revenues or operating expenses—MarketXLS provides numerous complementary historical fundamental functions (e.g., hf_Revenue, hf_Gross_Profit).


By using the hf_Price_Cash_Indicator function in Excel, you can quickly conduct historical price-cash ratio analyses for diverse securities. This empowers you to make more informed investment decisions and develop richer financial models right inside Excel.