---
title: "MF full data"
method: GET
path: "/mutual_funds/world"
tags: ["mutual_funds"]
---

# MF full data

`GET /mutual_funds/world`

The mutual full data endpoint provides detailed information about global mutual funds. It returns a comprehensive dataset that includes a summary of the fund, its performance metrics, risk assessment, ratings, asset composition, purchase details, and sustainability factors. This endpoint is essential for users seeking in-depth insights into mutual funds on a global scale, allowing them to evaluate various aspects such as investment performance, risk levels, and environmental impact.

## Query parameters

- `symbol` string
- `figi` string
- `isin` string
- `cusip` string
- `country` string
- `dp` integer

## Response `200`

- object
  - `mutual_fund` object, required — Mutual fund information
    - `summary` object — A brief summary of a mutual fund
      - `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, double — Percentage of profit of the fund since the first trading day of the current calendar year
      - `expense_ratio_net` number, double — Percentage of mutual fund 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
      - `min_investment` integer — Investment minimum
      - `turnover_rate` number, double — Percentage rate at which mutual fund 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
      - `people` object[] — Information about the fund’s managers
        - `name` string — Manager name
        - `tenure_since` string — Manager tenuring date
    - `performance` object — Detailed performance of a mutual fund
      - `trailing_returns` object[] — Trailing returns of the fund
        - `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
        - `rank_in_category` integer — Rank of a fund in category by total returns
      - `annual_total_returns` object[] — Annual total returns of the fund
        - `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
      - `quarterly_total_returns` object[] — Quarterly total returns of the fund
        - `year` integer — Year of a fund quarter return
        - `q1` number, double — Total return (%) of a fund in the first quarter
        - `q2` number, double — Total return (%) of a fund in the second quarter
        - `q3` number, double — Total return (%) of a fund in the third quarter
        - `q4` number, double — Total return (%) of a fund in the fourth quarter
      - `load_adjusted_return` object[] — Load adjusted return of the fund
        - `period` string — Period of a load adjusted return
        - `return` number, double — Actual return (%) an investor sees after accounting for fees and sales charges are deducted from a mutual fund's performance
    - `risk` object — Risk metrics of a mutual fund
      - `volatility_measures` object[] — Volatility statistics of the fund
        - `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_earnings_category` number, double — Average price to earnings metric of funds in the same category
        - `price_to_book` number, double — Fund price to book metric
        - `price_to_book_category` number, double — Average price to book metric of funds in the same category
        - `price_to_sales` number, double — Fund price to sales metric
        - `price_to_sales_category` number, double — Average price to sales metric of funds in the same category
        - `price_to_cashflow` number, double — Fund price to cashflow metric
        - `price_to_cashflow_category` number, double — Average price to cashflow metric of funds in the same category
        - `median_market_capitalization` integer — Median market capitalization of a fund
        - `median_market_capitalization_category` integer — Median market capitalization of funds in the same category
        - `3_year_earnings_growth` number, double — Earnings growth over the last three years
        - `3_year_earnings_growths_category` number, double — Earnings growth over the last three years of funds in the same category
    - `ratings` object — Ratings of a mutual fund
      - `performance_rating` integer — Performance rating from 0 to 5
      - `risk_rating` integer — Risk rating from 0 to 5
      - `return_rating` integer — Return rating from 0 to 5
    - `composition` object — Composition of a mutual fund
      - `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
      - `top_holdings` object[] — Top holdings of the 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
      - `asset_allocation` object — Asset allocation of the 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
      - `bond_breakdown` object — Breakdown of the fund’s bond holdings by maturity, duration, and credit quality
        - `average_maturity` object — Average maturity of bond holdings for the fund and its category
          - `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
        - `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
        - `average_duration` object — Average duration of bond holdings for the fund and its category
          - `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
    - `purchase_info` object — Purchase information of a mutual fund
      - `expenses` object — Costs associated with investing in the mutual fund, including gross and net expense ratios
        - `expense_ratio_gross` number, double — Cost of investing in a mutual fund
        - `expense_ratio_net` number, double — Percentage of mutual fund assets steered toward a fund's operating expenses and fund management fees
      - `minimums` object — Minimum investment amounts required to purchase or add to the mutual fund, including IRA minimums
        - `initial_investment` integer — Investment minimum
        - `additional_investment` integer — Minimum amount of additional investment
        - `initial_ira_investment` integer — Investment minimum for IRA
        - `additional_ira_investment` integer — Minimum amount of additional investment for IRA
      - `pricing` object — Pricing information for the mutual fund
        - `nav` number, double — Net Asset Value: fund value minus liabilities
        - `12_month_low` number, double — Lowest price of the fund over the last year
        - `12_month_high` number, double — Highest price of the fund over the last year
        - `last_month` number, double — Fund price at the end of the last month
      - `brokerages` string[] — List of brokerages where mutual fund can be purchased
    - `sustainability` object — Sustainability information of a mutual fund
      - `score` integer — Sustainability score: asset-weighted average of normalized company-level ESG Scores for the covered holdings in the portfolio from `0` to `100`
      - `corporate_esg_pillars` object — Corporate ESG pillars
        - `environmental` number, double — ESG environmental score
        - `social` number, double — ESG social score
        - `governance` number, double — ESG governance score
      - `sustainable_investment` boolean — Indication that the fund discloses in their prospectus that they employ socially responsible or ESG principles in their investment selection processes
      - `corporate_aum` number, double — Percentage of AUM used to calculate sustainability score
  - `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)
