> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-holders>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/yahoo-finance/instruments-symbol-holders.mdx>

---

# Yahoo Finance Holders API

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

`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.

## Request

- **Endpoint:** `GET /v1/yahoo-finance/instruments/{symbol}/holders`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by ticker
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/yahoo-finance/instruments/symbol/holders/get)
- **Platform page:** [/platforms/yahoo-finance](https://www.socialfetch.dev/platforms/yahoo-finance)

## 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.
