> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-statistics>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-statistics.mdx>

---

# Yahoo Finance Statistics API

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

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

## Request

- **Endpoint:** `GET /v1/yahoo-finance/instruments/{symbol}/statistics`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by ticker
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/yahoo-finance/instruments/symbol/statistics/get)
- **Platform page:** [/platforms/yahoo-finance](https://www.socialfetch.dev/platforms/yahoo-finance)

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