# Performance (High demand)

The mutual funds performances endpoint provides comprehensive performance data for mutual funds globally. It returns metrics such as trailing returns, annual returns, quarterly returns, and load-adjusted returns.

**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 mutual fund
  Example value: `1535462D`


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


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


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


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

- `mutual_fund` (object)
  Mutual fund information
  - `performance` (object)
    Detailed performance of a mutual fund
    - `trailing_returns` (array of object)
      Trailing returns of the fund
      - `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
      - `rank_in_category` (integer)
        Rank of a fund in category by total returns
    - `annual_total_returns` (array of object)
      Annual total returns of the fund
      - `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
    - `quarterly_total_returns` (array of object)
      Quarterly total returns of the fund
      - `year` (integer)
        Year of a fund quarter return
      - `q1` (number)
        Total return (%) of a fund in the first quarter
      - `q2` (number)
        Total return (%) of a fund in the second quarter
      - `q3` (number)
        Total return (%) of a fund in the third quarter
      - `q4` (number)
        Total return (%) of a fund in the fourth quarter
    - `load_adjusted_return` (array of object)
      Load adjusted return of the fund
      - `period` (string)
        Period of a load adjusted return
      - `return` (number)
        Actual return (%) an investor sees after accounting for fees and sales charges are deducted from a mutual fund's performance

- `status` (string)
  Status of the response


## Example Request

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

## Example Response

```json
{
    "mutual_fund": {
        "performance": {
            "trailing_returns": [
                {
                    "period": "ytd",
                    "share_class_return": -0.02986,
                    "category_return": 0.2019,
                    "rank_in_category": 76
                }
            ],
            "annual_total_returns": [
                {
                    "year": 2024,
                    "share_class_return": 0.08546,
                    "category_return": 0.1119
                }
            ],
            "quarterly_total_returns": [
                {
                    "year": 2024,
                    "q1": 0.02358,
                    "q2": -0.03071,
                    "q3": 0.10099,
                    "q4": -0.00629
                }
            ],
            "load_adjusted_return": [
                {
                    "period": "1_year",
                    "return": 0.06139
                }
            ]
        }
    },
    "status": "ok"
}
```