Mutual-fund-specific listings and snapshots: fund directories, issuer families, fund types, NAV history, dividend records, key ratios, and portfolio holdings. Ideal for long-term performance analysis and portfolio attribution.
The mutual funds directory endpoint provides a daily updated list of mutual funds, sorted in descending order by their total assets value. This endpoint is useful for retrieving an organized overview of available mutual funds.
Route
/mutual_funds/listAPI credits cost
1 per request
symbol
stringFilter by symbol
Example:
1535462D
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG00HMMLCH1
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
LU1206782309
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
120678230
cik
stringThe CIK of an instrument for which data is requested
Example:
95953
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
fund_family
stringFilter by investment company that manages the fund
Example:
Jackson National
fund_type
stringFilter by the type of fund
Example:
Small Blend
performance_rating
integerFilter by performance rating from 0 to 5
Example:
4
risk_rating
integerFilter by risk rating from 0 to 5
Example:
4
format
stringThe format of the response data
Supports: JSON, CSV
Default:
JSON
delimiter
stringThe separator used in the CSV response data
Default:
;
dp
integerNumber of decimal places for floating values
Default:
5
page
integerPage number
Default:
1
outputsize
integerNumber of records in response
Default:
100
Request example
Response
{
"result": {
"count": 1000,
"list": [
{
"symbol": "0P0001LCQ3",
"name": "JNL Small Cap Index Fund (I)",
"country": "United States",
"fund_family": "Jackson National",
"fund_type": "Small Blend",
"performance_rating": 2,
"risk_rating": 4,
"currency": "USD",
"exchange": "OTC",
"mic_code": "OTCM"
}
]
},
"status": "ok"
}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.
Route
/mutual_funds/worldAPI credits cost
1000 per request
symbol
stringSymbol ticker of mutual fund
Example:
1535462D
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG00HMMLCH1
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
LU1206782309
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
120678230
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Response
{
"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"
}The mutual funds summary endpoint provides a concise overview of global mutual funds, including key details such as fund name, symbol, asset class, and region. This endpoint is useful for quickly obtaining essential information about various mutual funds worldwide, aiding in the comparison and selection of funds for investment portfolios.
Route
/mutual_funds/world/summaryAPI credits cost
200 per request
symbol
stringSymbol ticker of mutual fund
Example:
1535462D
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG00HMMLCH1
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
LU1206782309
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
120678230
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Response
{
"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"
}
]
}
},
"status": "ok"
}The mutual funds performances endpoint provides comprehensive performance data for mutual funds globally. It returns metrics such as trailing returns, annual returns, quarterly returns, and load-adjusted returns.
Route
/mutual_funds/world/performanceAPI credits cost
200 per request
symbol
stringSymbol ticker of mutual fund
Example:
1535462D
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG00HMMLCH1
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
LU1206782309
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
120678230
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Request example
Response
{
"mutual_fund": {
"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
}
]
}
},
"status": "ok"
}The mutual funds risk endpoint provides detailed risk metrics for global mutual funds. It returns data such as standard deviation, beta, and Sharpe ratio, which help assess the volatility and risk profile of mutual funds across different markets.
Route
/mutual_funds/world/riskAPI credits cost
200 per request
symbol
stringSymbol ticker of mutual fund
Example:
1535462D
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG00HMMLCH1
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
LU1206782309
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
120678230
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Response
{
"mutual_fund": {
"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
}
}
},
"status": "ok"
}The mutual funds ratings endpoint provides detailed ratings for mutual funds across global markets. It returns data on the performance and quality of mutual funds, including ratings calculated in-house by Twelve Data and from various financial institutions.
Route
/mutual_funds/world/ratingsAPI credits cost
200 per request
symbol
stringSymbol ticker of mutual fund
Example:
1535462D
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG00HMMLCH1
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
LU1206782309
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
120678230
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Response
{
"mutual_fund": {
"ratings": {
"performance_rating": 2,
"risk_rating": 4,
"return_rating": 0
}
},
"status": "ok"
}The mutual funds compositions endpoint provides detailed information about the portfolio composition of a specified mutual fund. It returns data on sector allocations, individual holdings, and their respective weighted exposures. This endpoint is useful for users seeking to understand the investment distribution and risk profile of a mutual fund.
Route
/mutual_funds/world/compositionAPI credits cost
200 per request
symbol
stringSymbol ticker of mutual fund
Example:
1535462D
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG00HMMLCH1
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
LU1206782309
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
120678230
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Request example
Response
{
"mutual_fund": {
"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
}
]
}
}
},
"status": "ok"
}The mutual funds purchase information endpoint provides detailed purchasing details for global mutual funds. It returns data on minimum investment requirements, current pricing, and a list of brokerages where the mutual fund can be purchased. This endpoint is useful for users looking to understand the entry requirements and options available for investing in specific mutual funds.
Route
/mutual_funds/world/purchase_infoAPI credits cost
200 per request
symbol
stringSymbol ticker of mutual fund
Example:
1535462D
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG00HMMLCH1
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
LU1206782309
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
120678230
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Request example
Response
{
"mutual_fund": {
"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": []
}
},
"status": "ok"
}The mutual funds sustainability endpoint provides detailed information on the sustainability and Environmental, Social, and Governance (ESG) ratings of global mutual funds. It returns data such as ESG scores, sustainability metrics, and fund identifiers.
Route
/mutual_funds/world/sustainabilityAPI credits cost
200 per request
symbol
stringSymbol ticker of mutual fund
Example:
1535462D
figi
stringFilter by financial instrument global identifier (FIGI). This parameter is available on the Ultra plan (individual) and the Enterprise plan (business) and above.
Example:
BBG00HMMLCH1
isin
stringLook up an instrument by its International Securities Identification Number (ISIN). Available on all plans. Returning ISIN values in responses requires the ISIN Data add-on.
Example:
LU1206782309
cusip
stringLook up an instrument by its Committee on Uniform Securities Identification Procedures (CUSIP) number. Available on all plans. Returning CUSIP values in responses requires the CUSIP Data add-on.
Example:
120678230
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
dp
integerNumber of decimal places for floating values. Accepts value in range [0,11]
Default:
5
Request example
Response
{
"mutual_fund": {
"sustainability": {
"score": 22,
"corporate_esg_pillars": {
"environmental": 3.73,
"social": 10.44,
"governance": 7.86
},
"sustainable_investment": false,
"corporate_aum": 0.99486
}
},
"status": "ok"
}The mutual funds family endpoint provides a comprehensive list of MF families, which are groups of mutual funds managed by the same investment company. This data is useful for users looking to explore or compare different fund families, understand the range of investment options offered by each, and identify potential investment opportunities within specific fund families.
Route
/mutual_funds/familyAPI credits cost
1 per request
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
fund_family
stringFilter by investment company that manages the fund
Example:
Jackson National
Request example
Response
{
"result": {
"India": [
"Aberdeen Standard Fund Managers Limited",
"Aditya Birla Sun Life AMC Ltd"
],
"United States": [
"Aegon Asset Management UK PLC",
"Ampega Investment GmbH",
"Aviva SpA"
]
},
"status": "ok"
}This endpoint provides detailed information on various types of mutual funds, such as equity, bond, and balanced funds, allowing users to understand the different investment options available.
Route
/mutual_funds/typeAPI credits cost
1 per request
country
stringFilter by country name or alpha code, e.g., United States or US
Example:
United States
fund_type
stringFilter by the type of fund
Example:
Jackson National
Request example
Response
{
"result": {
"Singapore": [
"Property - Indirect Asia",
"Sector Equity Water",
"SGD Bond",
"Singapore Equity",
"Taiwan Large-Cap Equity"
],
"United States": [
"Asia-Pacific ex-Japan Equity",
"EUR Flexible Allocation - Global",
"Euro Short Bond PP",
"Large Blend",
"Other Allocation"
]
},
"status": "ok"
}