# Performance (High demand)

The ETFs performance endpoint provides comprehensive performance data for exchange-traded funds globally. It returns detailed metrics such as trailing returns and annual returns, enabling users to evaluate the historical performance of various ETFs. This endpoint is ideal for users looking to compare ETF performance over different time periods and assess their investment potential.

**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
  - `performance` (object)
    Detailed performance of a etf
    - `trailing_returns` (array of object)
      Performance returns of the fund and its category over various trailing time periods
      - `period` (string)
        Period of trailing returns
      - `share_class_return` (number)
        Fund returns (%) generated over a given period
      - `category_return` (number)
        Same category average returns (%) generated over a given period
    - `annual_total_returns` (array of object)
      Fund and category total returns (%) for each calendar year
      - `year` (integer)
        Year of total returns
      - `share_class_return` (number)
        Fund total returns (%) generated over a given year
      - `category_return` (number)
        Same category average total returns (%) generated over a given year

- `status` (string)
  Status of the response


## Example Request

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

## Example Response

```json
{
    "etf": {
        "performance": {
            "trailing_returns": [
                {
                    "period": "ytd",
                    "share_class_return": -0.0751,
                    "category_return": 0.1484
                }
            ],
            "annual_total_returns": [
                {
                    "year": 2021,
                    "share_class_return": 0.2866,
                    "category_return": 0
                }
            ]
        }
    },
    "status": "ok"
}
```