## download.download_data_damodaran()


Download and process Damodaran industry data.


Usage

``` python
download.download_data_damodaran(
    dataset="wacc",
    region="us",
    year=None,
)
```


Downloads industry averages from Aswath Damodaran's data library (https://pages.stern.nyu.edu/~adamodar/New_Home_Page/data.html). Currently, the cost of capital (WACC) by industry is supported via 'dataset="wacc"'. The source files are Excel workbooks, so the function requires the optional 'fastexcel' package ('pip install tidyfinance\[excel\]').

Damodaran updates the data each January with the data at the end of the previous year. The 'year' column refers to that previous year, e.g., the file published in January 2026 has 'year=2025'. Earlier years are read from the archive of the data library. The archive starts in 1998 for the US, in 2013 for Europe, Japan, emerging markets, global, China, and India, and in 2015 for Australia, New Zealand, and Canada. China and India skip some years.


## Parameters


`dataset: str = ``"wacc"`  
The dataset to download. Currently only 'wacc'.

`region: str or list of str = ``"us"`  
One or more regions: 'us', 'europe', 'japan', 'emerging', 'global', 'china', 'india', or 'rest' (Australia, New Zealand, and Canada).

`year: int or list of int = None`  
One or more years. If not provided, the most recent data is returned. Years that are not available are skipped with a warning.


## Returns


`pl.DataFrame`  
One row per region, year, and industry with the columns 'region', 'year', 'industry', 'number_of_firms', 'beta', 'cost_of_equity', 'equity_to_capital' (E/(D+E)), 'sd_stock' (standard deviation of stock returns), 'cost_of_debt', 'tax_rate', 'after_tax_cost_of_debt', 'debt_to_capital' (D/(D+E)), 'wacc' (cost of capital in US dollars), and 'wacc_local' (cost of capital in local currency, null where the source file does not provide it). Rates are decimals. The rows 'Total Market' and, in recent files, 'Total Market (without financials)' hold the market-wide averages.


## Raises


`ImportError`  
If the optional 'fastexcel' package is not installed.

`ValueError`  
If 'dataset', 'region', or 'year' is not supported.


## Examples

``` python
from tidyfinance import download_data
download_data('Damodaran', 'wacc')
download_data(
    'Damodaran', 'wacc', region=['us', 'europe'], year=range(2020, 2025)
)
```
