Yahoo Finance Fund API
Fund profile, performance, risk statistics and top holdings.
GET /v1/yahoo-finance/instruments/{symbol}/fund1 credit Failed requests are free
About this endpoint
GET /v1/yahoo-finance/instruments/{symbol}/fund returns data.fundProfile, data.fundPerformance and data.topHoldings. The profile carries family, categoryName, legalType, feesExpensesInvestment with annualReportExpenseRatio and totalNetAssets, and fundInceptionDate where available. totalNetAssets is in millions of the fund's currency. Performance carries overview fields such as ytdReturnPct, oneYearTotalReturn, threeYearTotalReturn, fiveYearTotalReturn and tenYearTotalReturn, plus risk fields such as beta3Year, sharpeRatio3Year and stdDev3Year.
The top holdings list carries symbol, holdingName and holdingPercent. A stock or other non-fund returns lookupStatus: not_found with null sections and data.sources.fund: not_found. Use the instrument route for the fund's current quote and the chart route for its price history.
Yahoo Finance Fund API FAQ
Does this work for ETFs and mutual funds?
Yes. Pass the fund ticker, for example SPY or QQQ. A stock returns lookupStatus: not_found because it has no fund profile.
Where are the fees and fund size?
In data.fundProfile.feesExpensesInvestment, with annualReportExpenseRatio and totalNetAssets when available. totalNetAssets is in millions of the fund's currency.
What performance fields are included?
Overview returns such as ytdReturnPct, oneYearTotalReturn, threeYearTotalReturn, fiveYearTotalReturn and tenYearTotalReturn, plus risk fields such as beta3Year, sharpeRatio3Year and stdDev3Year.
How many credits does this route cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Other Yahoo Finance endpoints
- InstrumentGET /v1/yahoo-finance/instruments/{symbol}
- QuotesGET /v1/yahoo-finance/quotes
- ChartGET /v1/yahoo-finance/instruments/{symbol}/chart
- ProfileGET /v1/yahoo-finance/instruments/{symbol}/profile
- StatisticsGET /v1/yahoo-finance/instruments/{symbol}/statistics
- FinancialsGET /v1/yahoo-finance/instruments/{symbol}/financials
- FundamentalsGET /v1/yahoo-finance/instruments/{symbol}/fundamentals
- EarningsGET /v1/yahoo-finance/instruments/{symbol}/earnings