# 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 on the <a href="https://twelvedata.com/pricing">Ultra</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Enterprise</a> plan (business) and above.

## Parameters

- `symbol` (string, optional, see notes)
  Symbol ticker of etf
  Example value: `IVV`


- `figi` (string, optional, see notes)
  Filter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
  Example value: `BBG000BVZ697`


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


- `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
  Example value: `464287200`


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


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


**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"
}
```