# Ratings

The mutual funds ratings endpoint provides detailed ratings for mutual funds across global markets. It returns data on the performance and quality of mutual funds, including ratings calculated in-house by Twelve Data and from various financial institutions.

**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
  - `ratings` (object)
    Ratings of a mutual fund
    - `performance_rating` (integer)
      Performance rating from 0 to 5
    - `risk_rating` (integer)
      Risk rating from 0 to 5
    - `return_rating` (integer)
      Return rating from 0 to 5

- `status` (string)
  Status of the response


## Example Request

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

## Example Response

```json
{
    "mutual_fund": {
        "ratings": {
            "performance_rating": 2,
            "risk_rating": 4,
            "return_rating": 0
        }
    },
    "status": "ok"
}
```