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 Holdings¶
The Mutual Fund Holdings Endpoint is used to return a list of holdings objects.
Request Info¶
Request Method |
GET |
URL |
https://api.ycharts.com/v3/mutual_funds/ |
Request Parameters¶
Parameter |
Required |
Description |
---|---|---|
symbol[s] |
Y |
The exchange symbol for a mutual fund, or a comma separated list of exchange symbols. |
Note
There is a maximum of 25 symbols per request.
Response Info¶
The response will contain one or more mutual fund objects. The key for each mutual fund object is the exchange symbol passed in the request.
Field |
Type |
Description |
---|---|---|
meta |
Meta |
This object contains information about the query for the mutual fund object. |
results |
Results |
This object contains one or more holding objects. |
Field |
Type |
Description |
---|---|---|
weight |
decimal |
Current Weight |
name |
string |
Name |
security_id |
string |
Security ID |
Examples¶
The following is an example successful request for 1 mutual fund.
Request URL
https://api.ycharts.com/v3/mutual_funds/M:VFIAX/holdings
Response
{
"meta": {
"status": "ok",
"url": "https://api.ycharts.com/v3/mutual_funds/M:VFIAX/holdings"
},
"response": {
"M:VFIAX": {
"meta": {
"status": "ok"
},
"results": {
"holdings": {
"meta": {
"status": "ok"
},
"data": [
{
"weight": 6.96,
"name": "Apple Inc",
"security_id": "AAPL"
}
]
}
}
}
}
}
The following is an example successful request for multiple mutual funds.
Request URL
https://api.ycharts.com/v3/mutual_funds/M:VFIAX,M:AWSHX/holdings
Response
{
"meta": {
"status": "ok",
"url": "https://api.ycharts.com/v3/mutual_funds/M:VFIAX,M:AWSHX/holdings"
},
"response": {
"M:VFIAX": {
"meta": {
"status": "ok"
},
"results": {
"holdings": {
"meta": {
"status": "ok"
},
"data": [
{
"weight": 6.96,
"name": "Apple Inc",
"security_id": "AAPL"
}
]
}
}
},
"M:AWSHX": {
"meta": {
"status": "ok"
},
"results": {
"holdings": {
"meta": {
"status": "ok"
},
"data": [
{
"weight": 5.97,
"name": "Broadcom Inc",
"security_id": "AVGO"
}
]
}
}
}
}
}
The following is an example incorrect request with a nonexistent mutual fund symbol.
Request URL
https://api.ycharts.com/v3/mutual_funds/M:VFXXX/holdings
Response
{
"meta": {
"status": "ok",
"url": "https://api.ycharts.com/v3/mutual_funds/M:VFXXX/holdings"
},
"response": {
"M:VFXXX": {
"meta": {
"status": "ok"
},
"results": {
"holdings": {
"meta": {
"status": "error",
"error_code": 404,
"error_message": "Security Not Found."
}
}
}
}
}
}