# MF full data (High demand)

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.

**API credits cost:** `1000` 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 mutual fund
  Example value: `1535462D`


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


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


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


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

- `mutual_fund` (object)
  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)
      Percentage of profit of the fund since the first trading day of the current calendar year
    - `expense_ratio_net` (number)
      Percentage of mutual fund 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
    - `min_investment` (integer)
      Investment minimum
    - `turnover_rate` (number)
      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` (array of 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` (array of object)
      Trailing returns of the fund
      - `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
      - `rank_in_category` (integer)
        Rank of a fund in category by total returns
    - `annual_total_returns` (array of object)
      Annual total returns of the fund
      - `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
    - `quarterly_total_returns` (array of object)
      Quarterly total returns of the fund
      - `year` (integer)
        Year of a fund quarter return
      - `q1` (number)
        Total return (%) of a fund in the first quarter
      - `q2` (number)
        Total return (%) of a fund in the second quarter
      - `q3` (number)
        Total return (%) of a fund in the third quarter
      - `q4` (number)
        Total return (%) of a fund in the fourth quarter
    - `load_adjusted_return` (array of object)
      Load adjusted return of the fund
      - `period` (string)
        Period of a load adjusted return
      - `return` (number)
        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` (array of object)
      Volatility statistics of the fund
      - `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_earnings_category` (number)
        Average price to earnings metric of funds in the same category
      - `price_to_book` (number)
        Fund price to book metric
      - `price_to_book_category` (number)
        Average price to book metric of funds in the same category
      - `price_to_sales` (number)
        Fund price to sales metric
      - `price_to_sales_category` (number)
        Average price to sales metric of funds in the same category
      - `price_to_cashflow` (number)
        Fund price to cashflow metric
      - `price_to_cashflow_category` (number)
        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)
        Earnings growth over the last three years
      - `3_year_earnings_growths_category` (number)
        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` (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
    - `asset_allocation` (object)
      Asset allocation of the 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 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)
        Weight of a holding instrument in overall portfolio composition
    - `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)
          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 holdings for the fund and its category
        - `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
  - `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)
        Cost of investing in a mutual fund
      - `expense_ratio_net` (number)
        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)
        Net Asset Value: fund value minus liabilities
      - `12_month_low` (number)
        Lowest price of the fund over the last year
      - `12_month_high` (number)
        Highest price of the fund over the last year
      - `last_month` (number)
        Fund price at the end of the last month
    - `brokerages` (array of 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)
        ESG environmental score
      - `social` (number)
        ESG social score
      - `governance` (number)
        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)
      Percentage of AUM used to calculate sustainability score

- `status` (string)
  Status of the response


## Example Request

```bash
curl "https://api.twelvedata.com/mutual_funds/world?symbol=1535462D&apikey=demo"
```

## Example Response

```json
{
    "mutual_fund": {
        "summary": {
            "symbol": "0P0001LCQ3",
            "name": "JNL Small Cap Index Fund (I)",
            "fund_family": "Jackson National",
            "fund_type": "Small Blend",
            "currency": "USD",
            "share_class_inception_date": "2021-04-26",
            "ytd_return": -0.02986,
            "expense_ratio_net": 0.001,
            "yield": 0,
            "nav": 10.09,
            "min_investment": 0,
            "turnover_rate": 0.32,
            "net_assets": 2400762112,
            "overview": "The fund invests, normally, at least 80% of its assets in the stocks...",
            "people": [
                {
                    "name": "John Doe",
                    "tenure_since": "2018-01-01"
                }
            ]
        },
        "performance": {
            "trailing_returns": [
                {
                    "period": "ytd",
                    "share_class_return": -0.02986,
                    "category_return": 0.2019,
                    "rank_in_category": 76
                }
            ],
            "annual_total_returns": [
                {
                    "year": 2024,
                    "share_class_return": 0.08546,
                    "category_return": 0.1119
                }
            ],
            "quarterly_total_returns": [
                {
                    "year": 2024,
                    "q1": 0.02358,
                    "q2": -0.03071,
                    "q3": 0.10099,
                    "q4": -0.00629
                }
            ],
            "load_adjusted_return": [
                {
                    "period": "1_year",
                    "return": 0.06139
                }
            ]
        },
        "risk": {
            "volatility_measures": [
                {
                    "period": "3_year",
                    "alpha": -9.12,
                    "alpha_category": -0.0939,
                    "beta": 1,
                    "beta_category": 0.0126,
                    "mean_annual_return": 0.45,
                    "mean_annual_return_category": 0.0117,
                    "r_squared": 69,
                    "r_squared_category": 0.8309,
                    "std": 23.15,
                    "std_category": 0.2554,
                    "sharpe_ratio": 0.04,
                    "sharpe_ratio_category": 0.005,
                    "treynor_ratio": -1.41,
                    "treynor_ratio_category": 0.0806
                }
            ],
            "valuation_metrics": {
                "price_to_earnings": 0.05695,
                "price_to_earnings_category": 20.63,
                "price_to_book": 0.55626,
                "price_to_book_category": 2.87,
                "price_to_sales": 0.97803,
                "price_to_sales_category": 1.34,
                "price_to_cashflow": 0.10564,
                "price_to_cashflow_category": 11.81,
                "median_market_capitalization": 2965,
                "median_market_capitalization_category": 4925,
                "3_year_earnings_growth": 16.32,
                "3_year_earnings_growths_category": 10.55
            }
        },
        "ratings": {
            "performance_rating": 2,
            "risk_rating": 4,
            "return_rating": 0
        },
        "composition": {
            "major_market_sectors": [
                {
                    "sector": "Industrials",
                    "weight": 0.1742
                }
            ],
            "asset_allocation": {
                "cash": 0.0043,
                "stocks": 0.9956,
                "preferred_stocks": 0,
                "convertables": 0,
                "bonds": 0,
                "others": 0
            },
            "top_holdings": [
                {
                    "symbol": "BBWI",
                    "name": "Bath & Body Works Inc",
                    "exchange": "NASDAQ",
                    "mic_code": "XNAS",
                    "weight": 0.00624
                }
            ],
            "bond_breakdown": {
                "average_maturity": {
                    "fund": 0,
                    "category": 1.97
                },
                "average_duration": {
                    "fund": 0,
                    "category": 1.64
                },
                "credit_quality": [
                    {
                        "grade": "U.S. Government",
                        "weight": 0
                    }
                ]
            }
        },
        "purchase_info": {
            "expenses": {
                "expense_ratio_gross": 0.0022,
                "expense_ratio_net": 0.001
            },
            "minimums": {
                "initial_investment": 0,
                "additional_investment": 0,
                "initial_ira_investment": 0,
                "additional_ira_investment": 0
            },
            "pricing": {
                "nav": 10.09,
                "12_month_low": 9.630000114441,
                "12_month_high": 12.10000038147,
                "last_month": 11.050000190735
            },
            "brokerages": []
        },
        "sustainability": {
            "score": 22,
            "corporate_esg_pillars": {
                "environmental": 3.73,
                "social": 10.44,
                "governance": 7.86
            },
            "sustainable_investment": false,
            "corporate_aum": 0.99486
        }
    },
    "status": "ok"
}
```