# Composition (High demand)

The ETFs composition endpoint provides detailed information about the composition of global Exchange-Traded Funds. It returns data on the sectors included in the ETF, specific holding details, and the weighted exposure of each component. This endpoint is useful for users who need to understand the specific makeup and sector distribution of an ETF portfolio.

**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 etf


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

- `etf` (object)
  Etf information
  - `composition` (object)
    Composition of a etf
    - `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
    - `country_allocation` (array of object)
      Breakdown of the fund’s portfolio by country and their respective weights
      - `country` (string)
        Country name
      - `allocation` (number)
        Percentages of a fund's net assets distributed to securities of the country
    - `asset_allocation` (object)
      Asset allocation of a 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 a 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 portfolio by bond holding characteristics
      - `average_maturity` (object)
        Average credit rating of bond holding of a fund
        - `fund` (number)
          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 holding of a fund
        - `fund` (number)
          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/etfs/world/composition?symbol=IVV&apikey=demo"
```

## Example Response

```json
{
    "etf": {
        "composition": {
            "major_market_sectors": [
                {
                    "sector": "Technology",
                    "weight": 0.2424
                }
            ],
            "country_allocation": [
                {
                    "country": "United Kingdom",
                    "allocation": 0.9855
                }
            ],
            "asset_allocation": {
                "cash": 0.0004,
                "stocks": 0.9996,
                "preferred_stocks": 0,
                "convertables": 0,
                "bonds": 0,
                "others": 0
            },
            "top_holdings": [
                {
                    "symbol": "AAPL",
                    "name": "Apple Inc",
                    "exchange": "NASDAQ",
                    "mic_code": "XNAS",
                    "weight": 0.0592
                }
            ],
            "bond_breakdown": {
                "average_maturity": {
                    "fund": 6.65,
                    "category": 7.81
                },
                "average_duration": {
                    "fund": 5.72,
                    "category": 5.64
                },
                "credit_quality": [
                    {
                        "grade": "AAA",
                        "weight": 0
                    }
                ]
            }
        }
    },
    "status": "ok"
}
```