# Risk

The ETFs risk endpoint provides essential risk metrics for global Exchange Traded Funds. It returns data such as volatility, beta, and other risk-related indicators, enabling users to assess the potential risk associated with investing in various ETFs worldwide.

**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 etf


- `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

- `etf` (object)
  Etf information
  - `risk` (object)
    Risk metrics of a etf
    - `volatility_measures` (array of object)
      Risk and volatility statistics of the fund and its category over different periods
      - `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_book` (number)
        Fund price to book metric
      - `price_to_sales` (number)
        Fund price to sales metric
      - `price_to_cashflow` (number)
        Fund price to cashflow metric

- `status` (string)
  Status of the response


## Example Request

```bash
curl "https://api.twelvedata.com/etfs/world/risk?symbol=IVV&apikey=demo"
```

## Example Response

```json
{
    "etf": {
        "risk": {
            "volatility_measures": [
                {
                    "period": "3_year",
                    "alpha": -0.03,
                    "alpha_category": -0.02,
                    "beta": 1,
                    "beta_category": 0.01,
                    "mean_annual_return": 1.58,
                    "mean_annual_return_category": 0.01,
                    "r_squared": 100,
                    "r_squared_category": 0.95,
                    "std": 18.52,
                    "std_category": 0.19,
                    "sharpe_ratio": 0.95,
                    "sharpe_ratio_category": 0.01,
                    "treynor_ratio": 17.41,
                    "treynor_ratio_category": 0.16
                }
            ],
            "valuation_metrics": {
                "price_to_earnings": 26.46,
                "price_to_book": 4.42,
                "price_to_sales": 2.96,
                "price_to_cashflow": 17.57
            }
        }
    },
    "status": "ok"
}
```