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

---

# Yahoo Finance Financials API

Income, balance-sheet and cash-flow periods as metric points.

`GET /v1/yahoo-finance/instruments/{symbol}/financials?statement=income&period=annual` returns `data.statement`, `data.period`, `data.metrics` and two views of the same data: `data.series`, grouped as `{ metric, points[] }`, and `data.points`, flat points with `metric`, `periodType`, `asOfDate`, `currency` and `value`.

Choose `statement=income`, `balance-sheet` or `cash-flow`, and `period=annual`, `quarterly` or `trailing`. Values can be null when there is no figure for a period. A symbol with no statements stays `lookupStatus: found` with empty lists and `data.sources.timeseries: empty`. The flat points view is the easy way to load a table; the series view is easier when you chart one metric over time.

## Request

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

## FAQ

### Which statements are supported?

Income, balance-sheet and cash-flow, selected with the statement parameter. The default is income.

### What periods can I request?

Annual, quarterly or trailing, selected with the period parameter. The default is annual. periodType on each point is the period of the figure, such as 12M, 3M or TTM.

### What does a point contain?

Each flat point has metric, periodType, asOfDate, currency and value. The same information appears under series grouped by metric.

### What if there are no statements?

data.series and data.points are empty lists. That is a completed answer for an instrument without statements, not a missing entity.

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