latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

etfs

Composition

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.

get/etfs/world/composition

Query parameters

symbolstring

Symbol ticker of etf

figistring

Filter by financial instrument global identifier (FIGI). This parameter 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.

isinstring

Filter by international securities identification number (ISIN). ISIN access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

cusipstring

The CUSIP of an instrument for which data is requested. CUSIP access is activating in the <a href="https://twelvedata.com/account/add-ons">Data add-ons</a> section

countrystring

Filter by country name or alpha code, e.g., United States or US

dpinteger

Number of decimal places for floating values. Accepts value in range [0,11]

Response

statusstring required

Status of the response

Example response

{
  "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
      },
      "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"
          }
        ]
      }
    }
  },
  "status": "ok"
}