Mutual Fund API

Parameters

Provide ticker or isin, but not both.

• ticker  optional

  Mutual Fund ticker symbol (e.g., VFIAX, FXAIX, FZROX). Funds outside the US that have no ticker are looked up by country code and local fund code, written COUNTRY:CODE (e.g., BR:07593976000164, CL:8026-8-A). See supported countries.

• isin  optional

  International Securities Identification Number of the Mutual Fund share class (e.g., US9229087104 for VFIAX, or ES0138841038 for a Spanish fund).

Supported countries

Headers

• X-Api-Key  required

  API Key associated with your account.

Response

The /v1/mutualfund endpoint returns a JSON object with the following fields, or an error if the request is unsuccessful.

• fund_ticker

  Mutual Fund ticker symbol. For a fund outside the US, its COUNTRY:CODE identifier (e.g. CL:8026-8-A), which can be passed back as ticker.

• fund_name

  Mutual Fund name.

• isin

  International Securities Identification Number (ISIN) of the Mutual Fund.

• cusip

  Nine-character Committee on Uniform Security Identification Procedures (CUSIP) identifier for the Mutual Fund.

• country

  Two-letter code of the country where the Mutual Fund is domiciled.

• currency

  Currency of price (ISO 4217, e.g. USD, BRL, EUR).

• expense_ratio Premium only

  Annual net expense ratio of the Mutual Fund, expressed as a percent (e.g. 0.04 means 0.04%). For funds outside the US, the total annual cost figure published in the fund's home market.

• price Premium only

  Latest net asset value (NAV) per share of the Mutual Fund, in currency. US mutual funds price once a day after the US market closes, usually publishing by 6pm ET, so this is the most recent daily NAV. Funds elsewhere price on their home market's schedule. null when no recent price is available.

• aum Premium only

  Assets under management of the Mutual Fund in aum_currency. For most funds this is the fund's total net assets across all of its share classes, as of its latest report; for money market funds and for share classes that report their own net assets, it is the share class's.

• aum_currency Premium only

  Currency of aum (ISO 4217).

• aum_usd Premium only

  aum converted to USD.

• holdings Premium only

  Array of the Mutual Fund's holdings, largest weight first: the most recent complete portfolio published for the fund. That is daily for funds that share a portfolio with an ETF share class, monthly for many fund families, money market funds and funds in several countries, and otherwise quarterly or semiannually, so check last_updated for the portfolio date.

  Field	Description
  ticker	Ticker of the held security, or null for positions without one, such as most bonds and money market instruments.
  name	Name of the held security.
  isin	ISIN of the held security, or null when none is reported (e.g. repurchase agreements).
  num_shares	Number of shares held; the principal amount for bonds. null when not reported.
  weight	Portfolio weight as a decimal fraction; 0.0751 means 7.51%.
  value	Position value in USD, converted from the fund's currency for funds outside the US. null when not reported.
  last_updated	Unix timestamp of the portfolio date.

• num_holdings Premium only

  Total number of holdings in the Mutual Fund.

• performance Business tier and above

  Trailing returns for this share class, built from monthly total returns: net of fees, with distributions reinvested. Values are percents: 17.75 means +17.75%. Available on the Business tier and above.

  Field	Description
  as_of	Last month-end the figures cover, usually 3–6 months before today.
  months_available	Number of monthly returns on file.
  return_1m return_3m return_6m return_ytd	Total return over the last 1, 3 and 6 months, and year to date.
  return_1y return_3y return_5y	Cumulative total return over the last 1, 3 and 5 years.
  annualized_3y annualized_5y	The 3- and 5-year returns, annualized.
  since	First month of history.
  return_since annualized_since	Cumulative and annualized return since since. annualized_since is null under 12 months.
  best_month worst_month	Best and worst single month, as month and total_return.
  volatility_3y	Annualized standard deviation of monthly returns over the last 3 years.
  monthly_returns	Every month on file, oldest first, as month and total_return.

  • Figures come from quarterly fund reports, not live prices, which is why as_of lags.
  • A period with any month missing is null, not estimated. There is no 10-year return.
  • Each share class has its own returns, so VFIAX and VFINX differ.
  • performance is null for a share class with no return history, such as a non-US or newly launched fund.