Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Markets API

The market summary, clock and ticker lists for a region.

GET /v1/yahoo-finance/markets

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/yahoo-finance/markets?region=US returns data.region, data.summary, data.clock, data.lists, data.currencies and data.sources. The summary holds indices, futures and crypto rows; the summary list is the same for every region, so region changes the ticker lists and localisation, not the summary itself. The clock reports market open, close and status by market. The lists hold currencies, commodities, bonds and world indices. The currencies array is the currency catalogue.

Send region as a two-letter code and language as a tag such as en-US. Quote-shaped rows are normalised like the instrument route: raw number fields, ISO times and no internal flags. data.sources reports which optional parts are available, so one section can be empty while the rest is complete. This route is the quickest way to build a market overview page without calling each instrument separately.

Yahoo Finance Markets API FAQ

What is in the market summary?

Indices, futures and crypto rows for the region, with their quote fields. The market clock and ticker lists are separate sections in the same response.

What does the market clock show?

Market open, close and status by market, so you can tell whether a market is open before you treat a price as current.

What are data.lists and data.currencies?

data.lists holds ticker lists for currencies, commodities, bonds and world indices. data.currencies is the currency catalogue.

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