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