Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Financials API

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

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

Yahoo Finance Financials API 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.

Other Yahoo Finance endpoints