Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Holders API

Who holds the stock: institutions, funds, the breakdown and direct holders.

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/yahoo-finance/instruments/{symbol}/holders returns data.institutionOwnership, data.fundOwnership, data.majorHoldersBreakdown and data.majorDirectHolders. Ownership lists carry rows such as organization, reportDate, pctHeld, position and value. The breakdown carries insidersPercentHeld, institutionsPercentHeld, institutionsFloatPercentHeld and institutionsCount. Direct holders carry name, relation, latestTransDate and position fields.

A symbol that exists but has no holder sections stays lookupStatus: found with null sections and data.sources.holders: empty. Read data.sources when you need to know which optional sections are available. The insiders route covers insider holders, transactions and net share purchases.

Yahoo Finance Holders API FAQ

What is the difference between institutional and fund ownership?

institutionOwnership lists institutions that report a position. fundOwnership lists funds. Both carry an organization, report date, percent held, position and value where available.

What is in the holder breakdown?

majorHoldersBreakdown reports the percentage held by insiders and institutions, the institutional float percentage and the institution count.

Why are some sections null?

The instrument kind does not report that section. A null section is a completed answer for that instrument, not a missing ticker.

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