Yahoo Finance hub

Yahoo Finance Fund API

Fund profile, performance, risk statistics and top holdings.

GET /v1/yahoo-finance/instruments/{symbol}/fund

1 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.