> **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-fundamentals>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-fundamentals.mdx>

---

# Yahoo Finance Fundamentals API

Known metric names in, statement points out, for one symbol and period.

`GET /v1/yahoo-finance/instruments/{symbol}/fundamentals?metrics=TotalRevenue,FreeCashFlow&period=annual` returns `data.metrics`, `data.series` and `data.points` for the base metric names you ask for. Send 1 to 100 names, comma-separated. Unknown names are refused with a 400, so a typo is a caller error rather than a silent empty series.

The point shape is the same as the financials route: `metric`, `periodType`, `asOfDate`, `currency` and `value`. Choose `period=annual`, `quarterly` or `trailing`. Use this route when you already know the metric names you want; use the financials route when you want a whole statement.

## Request

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

## FAQ

### Where do metric names come from?

Use base metric names such as TotalRevenue, NetIncome, FreeCashFlow, TotalAssets or StockholdersEquity. Common names include OperatingRevenue, CostOfRevenue, GrossProfit, OperatingIncome, BasicEPS, DilutedEPS, EBITDA, EBIT, InterestExpense, IncomeTaxPayable, ResearchAndDevelopment, SellingGeneralAndAdministration, OperatingCashFlow, InvestingCashFlow, FinancingCashFlow, CapitalExpenditure, CashAndCashEquivalents, CurrentAssets, TotalLiabilitiesNetMinorityInterest, CurrentLiabilities, TotalDebt, CommonStockEquity, RetainedEarnings, WorkingCapital, Inventory, AccountsReceivable, AccountsPayable and TotalCapitalization. Send up to 100 comma-separated names in metrics.

### What happens with an unknown metric?

The request returns a 400. Correct the name and retry; a bad name is not billed.

### How is this different from the financials route?

Fundamentals takes the metric names you choose. Financials returns a whole statement. Both use the same series and point shape.

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