Yahoo Finance

Get Yahoo Finance holders

Get Yahoo Finance institutional and fund holders and holder breakdown.

GET/v1/yahoo-finance/instruments/{symbol}/holders
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
symbolstringrequiredpath

Ticker symbol, case-insensitive, e.g. `AAPL`, `^GSPC`, `EURUSD=X`, `BTC-USD`, `7203.T`.

min 1 chars · max 40 chars · pattern: ^[A-Za-z0-9^=.-]+$

Response fields
12

Endpoint-specific response payload.

datalookupStatus
string

Whether the entity was found. HTTP 200 for both outcomes; branch on this field.

one of: found, not_found

datasymbol
string

Ticker symbol the sections belong to.

datasources
object

Status of each optional part of the result.

datainstitutionOwnership
objectnullable

Institutional holders with report date, shares, value and percent held. Null when it is not available.

datafundOwnership
objectnullable

Fund holders with report date, shares, value and percent held. Null when it is not available.

datamajorHoldersBreakdown
objectnullable

Insider and institutional ownership percentages and institution count. Null when it is not available.

datamajorDirectHolders
objectnullable

Direct holders with name, relation, latest transaction date and position. Null when it is not available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/yahoo-finance/instruments/AAPL/holders" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Yahoo Finance holder modules.