# ETF full data (High demand)

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.

**API credits cost:** `800` 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 etf
  Example value: `IVV`


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


- `isin` (string, optional, see notes)
  Filter by international securities identification number (ISIN). ISIN access is activating in the Data add-ons section
  Example value: `US4642872000`


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


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

- `etf` (object)
  Etf information
  - `summary` (object)
    A brief summary of a etf
    - `symbol` (string)
      All available fund types segmented by country
    - `name` (string)
      Fund name
    - `fund_family` (string)
      Investment company that manages the fund
    - `fund_type` (string)
      Type of the fund
    - `currency` (string)
      Currency of fund price
    - `share_class_inception_date` (string)
      The date from which the fund started operations and the returns are calculated
    - `ytd_return` (number)
      Percentage of profit of the fund since the first trading day of the current calendar year
    - `expense_ratio_net` (number)
      Percentage of ETF assets steered toward a fund's operating expenses and fund management fees
    - `yield` (number)
      Income returned to its investors through interest and dividends generated by the fund's investments
    - `nav` (number)
      Net Asset Value: fund value minus liabilities
    - `last_price` (number)
      Last price of the fund
    - `turnover_rate` (number)
      Percentage rate at which ETF replaces its holdings on investment every year
    - `net_assets` (integer)
      Total assets of a fund minus its total liabilities
    - `overview` (string)
      Description of the fund
  - `performance` (object)
    Detailed performance of a etf
    - `trailing_returns` (array of object)
      Performance returns of the fund and its category over various trailing time periods
      - `period` (string)
        Period of trailing returns
      - `share_class_return` (number)
        Fund returns (%) generated over a given period
      - `category_return` (number)
        Same category average returns (%) generated over a given period
    - `annual_total_returns` (array of object)
      Fund and category total returns (%) for each calendar year
      - `year` (integer)
        Year of total returns
      - `share_class_return` (number)
        Fund total returns (%) generated over a given year
      - `category_return` (number)
        Same category average total returns (%) generated over a given year
  - `risk` (object)
    Risk metrics of a etf
    - `volatility_measures` (array of object)
      Risk and volatility statistics of the fund and its category over different periods
      - `period` (string)
        Period of a measure
      - `alpha` (number)
        Alpha score of a fund
      - `alpha_category` (number)
        Average alpha score of a fund's category
      - `beta` (number)
        Beta score of a fund
      - `beta_category` (number)
        Average beta score of a fund's category
      - `mean_annual_return` (number)
        Mean annual return of a fund
      - `mean_annual_return_category` (number)
        Average mean annual return of a fund's category
      - `r_squared` (number)
        R-squared metric of a fund
      - `r_squared_category` (number)
        Average r-squared metric of a fund's category
      - `std` (number)
        Standard deviation of a fund
      - `std_category` (number)
        Average standard deviation of a fund's category
      - `sharpe_ratio` (number)
        Sharpe ratio of a fund
      - `sharpe_ratio_category` (number)
        Average sharpe ratio of a fund's category
      - `treynor_ratio` (number)
        Treynor ratio of a fund
      - `treynor_ratio_category` (number)
        Average treynor ratio of a fund's category
    - `valuation_metrics` (object)
      Valuation ratios and metrics of the fund and its category
      - `price_to_earnings` (number)
        Fund price to earnings metric
      - `price_to_book` (number)
        Fund price to book metric
      - `price_to_sales` (number)
        Fund price to sales metric
      - `price_to_cashflow` (number)
        Fund price to cashflow metric
  - `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?symbol=IVV&apikey=demo"
```

## Example Response

```json
{
    "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,
                    "category_return": 0
                }
            ]
        },
        "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,
                "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"
}
```