Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Instrument API

One ticker's quote record and instrument kind, with the exchange delay attached.

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/yahoo-finance/instruments/{symbol} returns data.instrument, the quote record, and data.quoteType, the instrument kind. The quote carries fields such as symbol, shortName, longName, currency, exchange, marketState, regularMarketPrice, regularMarketChange, regularMarketChangePercent, regularMarketTime and exchangeDataDelayedBy.

data.sources.quote and data.sources.quoteType report which parts are available, so a found quote with an unavailable quote type is visible rather than silent. An unknown ticker returns lookupStatus: not_found with both records null. A stub quote with no name and no price is also not_found; note that a dotted US class such as BRK.B is a stub, while the real ticker is BRK-B. Use the chart route when you need price history and the quotes route when you have a list of symbols.

Yahoo Finance Instrument API FAQ

How do I pass a symbol?

Use the ticker as Yahoo Finance writes it: AAPL, ^GSPC, EURUSD=X, BTC-USD or 7203.T. The symbol goes in the path, not the query string.

What is the difference between instrument and quoteType?

data.instrument is the quote record with price and market fields. data.quoteType is the instrument kind record, useful when you need to know whether the symbol is an equity, ETF, index or currency before you call another route.

What if the quote type is unavailable?

data.lookupStatus can still be found while data.sources.quoteType is unavailable. The quote record is returned and data.quoteType is null; retry later rather than treating the whole lookup as missing.

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