Institutional ownership history

GET/api/ownership/institutional-holders/history

Returns quarterly time series of institutional ownership for a stock. Each entry represents one quarter's aggregated 13F data: total holder count, shares, value, and ownership percentage. Useful for tracking how institutional interest in a stock has changed over time.

For symbols without an issuer-level shares-outstanding figure (e.g. ETFs, funds), the pctOfSharesOutstanding field is omitted from each entry.

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

Example request

curl 'https://api.stockfit.io/v1/api/ownership/institutional-holders/history?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Quarterly ownership data points sorted chronologically (ascending)

Response schema

array of:

reportDate string
Quarter end date (YYYY-MM-DD)
holderCount integer
Number of distinct institutional holders that quarter
totalShares number
Total shares held by all institutions
totalValue number
Total market value of all institutional holdings (USD)
pctOfSharesOutstanding number
Total institutional ownership as percentage of shares outstanding. Omitted when no issuer-level shares-outstanding figure is available (e.g. for ETFs/funds).

Example response

[
  {
    "reportDate": "2025-09-30",
    "holderCount": 2801,
    "totalShares": 10087654321,
    "totalValue": 2456789012000,
    "pctOfSharesOutstanding": 68.62
  }
]

400 Bad Request

Invalid parameters or company not found

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}