# Composition (High demand)

The mutual funds compositions endpoint provides detailed information about the portfolio composition of a specified mutual fund. It returns data on sector allocations, individual holdings, and their respective weighted exposures. This endpoint is useful for users seeking to understand the investment distribution and risk profile of a mutual fund.

**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
  - `composition` (object)
    Mutual fund composition
    - `major_market_sectors` (array of object)
      Breakdown of the fund’s portfolio by major industry sectors and their respective weights
      - `sector` (string)
        Sector category of a fund exposure
      - `weight` (number)
        Weight of a fund exposure in a sector
    - `asset_allocation` (object)
      Asset allocation of the fund by different asset classes and their respective weights
      - `cash` (number)
        Percentage of overall portfolio composition in cash
      - `stocks` (number)
        Percentage of overall portfolio composition in stocks
      - `preferred_stocks` (number)
        Percentage of overall portfolio composition in preferred stocks
      - `convertables` (number)
        Percentage of overall portfolio composition in convertable securities
      - `bonds` (number)
        Percentage of overall portfolio composition in bond
      - `others` (number)
        Percentage of overall portfolio composition in other forms of holding
    - `top_holdings` (array of object)
      Top holdings of the fund with their respective weights in the overall portfolio composition
      - `symbol` (string)
        Symbol ticker of a holding instrument
      - `name` (string)
        Name of a holding instrument
      - `exchange` (string)
        Exchange where instrument is traded
      - `mic_code` (string)
        Market Identifier Code (MIC) under ISO 10383 standard
      - `weight` (number)
        Weight of a holding instrument in overall portfolio composition
    - `bond_breakdown` (object)
      Breakdown of the fund’s bond holdings by maturity, duration, and credit quality
      - `average_maturity` (object)
        Average maturity of bond holdings for the fund and its category
        - `fund` (string)
          Average maturity of bond holding of a fund
        - `category` (number)
          Average maturity of bond holding of funds in the same category
      - `average_duration` (object)
        Average duration of bond holdings for the fund and its category
        - `fund` (string)
          Average duration of bond holding of a fund
        - `category` (number)
          Average duration of bond holding of funds in the same category
      - `credit_quality` (array of object)
        Breakdown of the fund’s bond holdings by credit rating and their respective portfolio weights
        - `grade` (string)
          Rating of bond holding of a fund from AAA to below B
        - `weight` (number)
          Weight of bond holding in fund portfolio

- `status` (string)
  Status of the response


## Example Request

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

## Example Response

```json
{
    "mutual_fund": {
        "composition": {
            "major_market_sectors": [
                {
                    "sector": "Industrials",
                    "weight": 0.1742
                }
            ],
            "asset_allocation": {
                "cash": 0.0043,
                "stocks": 0.9956,
                "preferred_stocks": 0,
                "convertables": 0,
                "bonds": 0,
                "others": 0
            },
            "top_holdings": [
                {
                    "symbol": "BBWI",
                    "name": "Bath & Body Works Inc",
                    "exchange": "NASDAQ",
                    "mic_code": "XNAS",
                    "weight": 0.00624
                }
            ],
            "bond_breakdown": {
                "average_maturity": {
                    "fund": null,
                    "category": 1.97
                },
                "average_duration": {
                    "fund": null,
                    "category": 1.64
                },
                "credit_quality": [
                    {
                        "grade": "U.S. Government",
                        "weight": 0
                    }
                ]
            }
        }
    },
    "status": "ok"
}
```