--- title: "ETF full data" method: GET path: "/etfs/world" tags: ["etfs"] --- # ETF full data `GET /etfs/world` 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. ## Query parameters - `symbol` string - `figi` string - `isin` string - `cusip` string - `country` string - `dp` integer ## Response `200` - object - `etf` object, required — Etf information - `summary` object — A brief summary of a etf - `symbol` string, required — All available fund types segmented by country - `name` string, required — 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, double — Percentage of profit of the fund since the first trading day of the current calendar year - `expense_ratio_net` number, double — Percentage of ETF assets steered toward a fund's operating expenses and fund management fees - `yield` number, double — Income returned to its investors through interest and dividends generated by the fund's investments - `nav` number, double — Net Asset Value: fund value minus liabilities - `last_price` number, double — Last price of the fund - `turnover_rate` number, double — 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` object[] — Performance returns of the fund and its category over various trailing time periods - `period` string — Period of trailing returns - `share_class_return` number, double — Fund returns (%) generated over a given period - `category_return` number, double — Same category average returns (%) generated over a given period - `annual_total_returns` object[] — Fund and category total returns (%) for each calendar year - `year` integer — Year of total returns - `share_class_return` number, double — Fund total returns (%) generated over a given year - `category_return` number, double — Same category average total returns (%) generated over a given year - `risk` object — Risk metrics of a etf - `volatility_measures` object[] — Risk and volatility statistics of the fund and its category over different periods - `period` string — Period of a measure - `alpha` number, double — Alpha score of a fund - `alpha_category` number, double — Average alpha score of a fund's category - `beta` number, double — Beta score of a fund - `beta_category` number, double — Average beta score of a fund's category - `mean_annual_return` number, double — Mean annual return of a fund - `mean_annual_return_category` number, double — Average mean annual return of a fund's category - `r_squared` number, double — R-squared metric of a fund - `r_squared_category` number, double — Average r-squared metric of a fund's category - `std` number, double — Standard deviation of a fund - `std_category` number, double — Average standard deviation of a fund's category - `sharpe_ratio` number, double — Sharpe ratio of a fund - `sharpe_ratio_category` number, double — Average sharpe ratio of a fund's category - `treynor_ratio` number, double — Treynor ratio of a fund - `treynor_ratio_category` number, double — 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, double — Fund price to earnings metric - `price_to_book` number, double — Fund price to book metric - `price_to_sales` number, double — Fund price to sales metric - `price_to_cashflow` number, double — Fund price to cashflow metric - `composition` object — Composition of a etf - `major_market_sectors` 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, double — Weight of a fund exposure in a sector - `country_allocation` object[] — Breakdown of the fund’s portfolio by country and their respective weights - `country` string — Country name - `allocation` number, double — 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, double — Percentage of overall portfolio composition in cash - `stocks` number, double — Percentage of overall portfolio composition in stocks - `preferred_stocks` number, double — Percentage of overall portfolio composition in preferred stocks - `convertables` number, double — Percentage of overall portfolio composition in convertable securities - `bonds` number, double — Percentage of overall portfolio composition in bond - `others` number, double — Percentage of overall portfolio composition in other forms of holding - `top_holdings` 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, double — 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, double — Average maturity of bond holding of a fund - `category` number, double — Average maturity of bond holding of funds in the same category - `average_duration` object — Average duration of bond holding of a fund - `fund` number, double — Average duration of bond holding of a fund - `category` number, double — Average duration of bond holding of funds in the same category - `credit_quality` 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, double — Weight of bond holding in fund portfolio - `status` string, required — Status of the response ## Other responses - `400` - `401` - `403` - `404` - `414` - `429` - `500` --- [API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)