# Risk

The mutual funds risk endpoint provides detailed risk metrics for global mutual funds. It returns data such as standard deviation, beta, and Sharpe ratio, which help assess the volatility and risk profile of mutual funds across different markets.

**API credits cost:** `200` per request

> **Note:** This API endpoint is available starting with the [Ultra](https://twelvedata.com/pricing) plan.

## Parameters

- `symbol` (string, optional, see notes)
  Symbol ticker of mutual fund


- `figi` (string, optional, see notes)
  Filter by financial instrument global identifier (FIGI). This request parameter is available starting with the Ultra plan


- `isin` (string, optional, see notes)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section


- `cusip` (string, optional, see notes)
  The CUSIP of an instrument for which data is requested. CUSIP access is activating in the Data add-ons section


- `country` (string, optional)
  Filter by country name or alpha code, e.g., `United States` or `US`


- `dp` (integer, optional)
  Number of decimal places for floating values. Accepts value in range [0,11]


**Notes:**

 - At least one of the following parameters is required: `symbol`, `figi`, `isin`, `cusip`.

## Response

- `mutual_fund` (object)
  Mutual fund information
  - `risk` (object)
    Risk and volatility statistics of the fund and its category over different periods
    - `volatility_measures` (array of object)
      Volatility statistics of the fund
      - `period` (string)
        Period of a measure
      - `alpha` (number)
        Alpha score of a fund
      - `alpha_category` (number)
        Average alpha score of a fund's category
      - `beta` (number)
        Beta score of a fund
      - `beta_category` (number)
        Average beta score of a fund's category
      - `mean_annual_return` (number)
        Mean annual return of a fund
      - `mean_annual_return_category` (number)
        Average mean annual return of a fund's category
      - `r_squared` (number)
        R-squared metric of a fund
      - `r_squared_category` (number)
        Average r-squared metric of a fund's category
      - `std` (number)
        Standard deviation of a fund
      - `std_category` (number)
        Average standard deviation of a fund's category
      - `sharpe_ratio` (number)
        Sharpe ratio of a fund
      - `sharpe_ratio_category` (number)
        Average sharpe ratio of a fund's category
      - `treynor_ratio` (number)
        Treynor ratio of a fund
      - `treynor_ratio_category` (number)
        Average treynor ratio of a fund's category
    - `valuation_metrics` (object)
      Valuation ratios and metrics of the fund and its category
      - `price_to_earnings` (number)
        Fund price to earnings metric
      - `price_to_earnings_category` (number)
        Average price to earnings metric of funds in the same category
      - `price_to_book` (number)
        Fund price to book metric
      - `price_to_book_category` (number)
        Average price to book metric of funds in the same category
      - `price_to_sales` (number)
        Fund price to sales metric
      - `price_to_sales_category` (number)
        Average price to sales metric of funds in the same category
      - `price_to_cashflow` (number)
        Fund price to cashflow metric
      - `price_to_cashflow_category` (number)
        Average price to cashflow metric of funds in the same category
      - `median_market_capitalization` (integer)
        Median market capitalization of a fund
      - `median_market_capitalization_category` (integer)
        Median market capitalization of funds in the same category
      - `3_year_earnings_growth` (number)
        Earnings growth over the last three years
      - `3_year_earnings_growths_category` (number)
        Earnings growth over the last three years of funds in the same category

- `status` (string)
  Status of the response


## Example Request

```bash
curl "https://api.twelvedata.com/mutual_funds/world/risk?symbol=1535462D&apikey=demo"
```

## Example Response

```json
{
    "mutual_fund": {
        "risk": {
            "volatility_measures": [
                {
                    "period": "3_year",
                    "alpha": -9.12,
                    "alpha_category": -0.0939,
                    "beta": 1,
                    "beta_category": 0.0126,
                    "mean_annual_return": 0.45,
                    "mean_annual_return_category": 0.0117,
                    "r_squared": 69,
                    "r_squared_category": 0.8309,
                    "std": 23.15,
                    "std_category": 0.2554,
                    "sharpe_ratio": 0.04,
                    "sharpe_ratio_category": 0.005,
                    "treynor_ratio": -1.41,
                    "treynor_ratio_category": 0.0806
                }
            ],
            "valuation_metrics": {
                "price_to_earnings": 0.05695,
                "price_to_earnings_category": 20.63,
                "price_to_book": 0.55626,
                "price_to_book_category": 2.87,
                "price_to_sales": 0.97803,
                "price_to_sales_category": 1.34,
                "price_to_cashflow": 0.10564,
                "price_to_cashflow_category": 11.81,
                "median_market_capitalization": 2965,
                "median_market_capitalization_category": 4925,
                "3_year_earnings_growth": 16.32,
                "3_year_earnings_growths_category": 10.55
            }
        }
    },
    "status": "ok"
}
```