Warning
The YCharts API is available to our API customers for their internal use only. Any redistribution or commercial use of data from the API is strictly prohibited without prior written consent from YCharts. For more details on our API’s capabilities and pricing please contact sales@ycharts.com or call (866) 965-7552.
Mutual Fund Info Fields¶
The Mutual Fund Info Field Endpoint is used to obtain information about one or more mutual funds.
Note
Full list of fields can be found in the Reference Guide
Request Info¶
Request Method |
GET |
URL |
/v3/mutual_funds/ |
Request Parameters¶
Parameter |
Required |
Description |
---|---|---|
symbol[s] |
Y |
The exchange symbol for a mutual fund, or comma separated list of exchange symbols |
fields[s] |
Y |
A comma separated list of info fields from the list below |
Note
There is a maximum of 100 mutual funds per request. In addition, there is a maximum of 100 fields per request.
Examples¶
The following is an example successful response
Request URL
https://api.ycharts.com/v3/mutual_funds/M:FCNTX/info/aum_usd,equity_style,open_to_new_investors,share_class
Response
{
"meta": {
"status": "ok",
"url": "https://api.ycharts.com/v3/mutual_funds/M:FCNTX/info/aum_usd,equity_style,open_to_new_investors,share_class"
},
"response": {
"M:FCNTX": {
"meta": {
"status": "ok"
},
"results": {
"aum_usd": {
"data": 76127150132.0,
"meta": {
"status": "ok"
}
},
"equity_style": {
"data": "Large Cap/Growth",
"meta": {
"status": "ok"
}
},
"open_to_new_investors": {
"data": true,
"meta": {
"status": "ok"
}
},
"share_class": {
"data": "No Load",
"meta": {
"status": "ok"
}
}
}
}
}
}
The following is an example successful multi mutual fund response
Request URL
https://api.ycharts.com/v3/mutual_funds/M:FCNTX,M:VFIAX/info/aum_usd,equity_style,open_to_new_investors,share_class
Response
{
"meta": {
"status": "ok",
"url": "https://api.ycharts.com/v3/mutual_funds/M:FCNTX,M:VFIAX/info/aum_usd,equity_style,open_to_new_investors,share_class"
},
"response": {
"M:FCNTX": {
"meta": {
"status": "ok"
},
"results": {
"aum_usd": {
"data": 76127150132.0,
"meta": {
"status": "ok"
}
},
"equity_style": {
"data": "Large Cap/Growth",
"meta": {
"status": "ok"
}
},
"open_to_new_investors": {
"data": true,
"meta": {
"status": "ok"
}
},
"share_class": {
"data": "No Load",
"meta": {
"status": "ok"
}
}
}
},
"M:VFIAX": {
"meta": {
"status": "ok"
},
"results": {
"aum_usd": {
"data": 157669165756.0,
"meta": {
"status": "ok"
}
},
"equity_style": {
"data": "Large Cap/Blend",
"meta": {
"status": "ok"
}
},
"open_to_new_investors": {
"data": true,
"meta": {
"status": "ok"
}
},
"share_class": {
"data": "Other",
"meta": {
"status": "ok"
}
}
}
}
}
}
The following is an example incorrect request, which requests a mutual fund that does not exist
Request URL
https://api.ycharts.com/v3/mutual_funds/M:BADID/info/aum_usd,equity_style,open_to_new_investors,share_class
Response
{
"meta": {
"status": "ok",
"url": "https://api.ycharts.com/v3/mutual_funds/M:BADID/info/aum_usd,equity_style,open_to_new_investors,share_class"
},
"response": {
"M:BADID": {
"meta": {
"error_code": 404,
"error_message": "Symbol Not Found.",
"status": "error"
}
}
}
}
The following is an example of an incorrect request that requests info fields that do not exist
Request URL
https://api.ycharts.com/v3/mutual_funds/M:FCNTX/info/fake_field_one,fake_field_two
Response
{
"meta": {
"status": "ok",
"url": "https://api.ycharts.com/v3/mutual_funds/M:FCNTX/info/fake_field_one,fake_field_two"
},
"response": {
"M:FCNTX": {
"meta": {
"status": "ok"
},
"results": {
"fake_field_one": {
"meta": {
"error_code": 404,
"error_message": "Info Field Not Found.",
"status": "error"
}
},
"fake_field_two": {
"meta": {
"error_code": 404,
"error_message": "Info Field Not Found.",
"status": "error"
}
}
}
}
}
}