Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Fundamentals API

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

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

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

Other Yahoo Finance endpoints