Yahoo Finance hub

Yahoo Finance Related API

Scored recommendations and related tickers for one symbol.

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

1 credit Failed requests are free

About this endpoint

GET /v1/yahoo-finance/instruments/{symbol}/related returns data.recommendations and data.recommendedSymbols. Recommendation rows carry symbol and score and come from the recommendation service. recommendedSymbols is a list of ticker strings from the stock recommender.

data.sources reports which parts are available, so one list can be empty while the other is filled. Use this route to build a peer set for comparison, then hydrate the tickers with the instrument, chart or statistics routes. An unknown ticker returns lookupStatus: not_found.

Yahoo Finance Related API FAQ

What does the recommendation score mean?

It is the score the recommendation service attaches to that related symbol. A higher score means a closer recommendation. The field is null when the service does not provide a score.

Why are there two lists?

recommendations has symbol and score rows. recommendedSymbols is a plain ticker list from the stock recommender. They come from separate surfaces and one can be empty.

How do I use related tickers?

Take the symbols from either list and call the instrument, chart or statistics route for each one. That keeps the peer set and the data for each peer separate.

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.