latestSwagger 2.02026-08-12187723.0 MB

c4a12725cdb5

etfs

ETF full data

The ETF full data endpoint provides detailed information about global Exchange-Traded Funds. It returns comprehensive data, including a summary, performance metrics, risk assessment, and composition details. This endpoint is ideal for users seeking an in-depth analysis of worldwide ETFs, enabling them to access key financial metrics and portfolio breakdowns.

get/etfs/world

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": {
    "summary": {
      "symbol": "IVV",
      "name": "iShares Core S&P 500 ETF",
      "fund_family": "iShares",
      "fund_type": "Large Blend",
      "currency": "USD",
      "share_class_inception_date": "2000-11-13",
      "ytd_return": -0.0537,
      "expense_ratio_net": -0.004,
      "yield": 0.0133,
      "nav": 413.24,
      "last_price": 413.24,
      "turnover_rate": 0.04,
      "net_assets": 753409982464,
      "overview": "The investment seeks to track the performance of the Standard & Poor's 500..."
    },
    "performance": {
      "trailing_returns": [
        {
          "period": "ytd",
          "share_class_return": -0.0751,
          "category_return": 0.1484
        }
      ],
      "annual_total_returns": [
        {
          "year": 2021,
          "share_class_return": 0.2866
        }
      ]
    },
    "risk": {
      "volatility_measures": [
        {
          "period": "3_year",
          "alpha": -0.03,
          "alpha_category": -0.02,
          "beta": 1,
          "beta_category": 0.01,
          "mean_annual_return": 1.58,
          "mean_annual_return_category": 0.01,
          "r_squared": 100,
          "r_squared_category": 0.95,
          "std": 18.52,
          "std_category": 0.19,
          "sharpe_ratio": 0.95,
          "sharpe_ratio_category": 0.01,
          "treynor_ratio": 17.41,
          "treynor_ratio_category": 0.16
        }
      ],
      "valuation_metrics": {
        "price_to_earnings": 26.46,
        "price_to_book": 4.42,
        "price_to_sales": 2.96,
        "price_to_cashflow": 17.57
      }
    },
    "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"
}