Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Statistics API

Key ratios, financial health fields and valuation points for one ticker.

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/yahoo-finance/instruments/{symbol}/statistics returns data.defaultKeyStatistics, data.summaryDetail, data.financialData and data.valuation. The statistics sections carry fields such as trailingPE, forwardPE, priceToBook, enterpriseValue, profitMargins, returnOnEquity, totalCash, totalDebt, beta, sharesOutstanding, heldPercentInsiders, heldPercentInstitutions and floatShares. The summary detail adds marketCap, dividendYield, fiftyTwoWeekHigh, fiftyTwoWeekLow and averageVolume.

data.valuation is a flat list of statement points, each with metric, label, periodType, asOfDate, currency and value. The labels are marketCap, enterpriseValue, trailingPE, forwardPE, pegRatio, priceToSales, priceToBook, enterpriseValueToRevenue and enterpriseValueToEbitda, in that order for the current period. The pegRatio row uses the current PEG measure and can differ from defaultKeyStatistics.pegRatio. A symbol that exists but has no statements stays lookupStatus: found with an empty valuation and data.sources.timeseries: empty. Missing sections are null with data.sources.statistics: empty, so check each section before reading a ratio.

Yahoo Finance Statistics API FAQ

Which ratios are in defaultKeyStatistics?

Fields such as trailingPE, forwardPE, priceToBook, enterpriseValue, profitMargins, returnOnEquity, beta, sharesOutstanding, heldPercentInsiders and heldPercentInstitutions, when available.

What is in data.valuation?

It is a list of points with metric, label, periodType, asOfDate, currency and value. The labels are marketCap, enterpriseValue, trailingPE, forwardPE, pegRatio, priceToSales, priceToBook, enterpriseValueToRevenue and enterpriseValueToEbitda. The pegRatio row uses the current PEG measure and can differ from defaultKeyStatistics.pegRatio. It is empty when the instrument has no statements; data.sources.timeseries says empty rather than ok.

Why is a section null?

The instrument kind does not have that section. The rest of the response is still usable, and data.sources shows which optional parts are available.

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