---
title: "Stock Fund Holdings"
method: POST
path: "/v1/holdings/stocks/funds"
tags: ["Fund Holdings"]
---

# Stock Fund Holdings

`POST /v1/holdings/stocks/funds`

Retrieve institutional fund holdings for a specified stock, based on the latest SEC 13F filings. The endpoint returns top holders with their current market value, share count, quarterly change, and estimated capital flow. This allows users to identify leading institutional investors, track changes in ownership, and analyze fund activity trends such as increases or reductions in positions.

## Request body

- PublicGetCompanyFundsHoldingsQuery — Schema for the request to the public API.
  - `identifier` SingleIdentifier, required
    - `type` 'rp_entity_id', required
    - `value` string, required — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`)
  - `filters` CompanyFundsHoldingsFilters — Extended filters for stock funds holdings.
    - `year` integer — Fiscal year for the holdings data
    - `quarter` 1 | 2 | 3 | 4 — Enum for quarters values.

## Response `200`

Successful Response

- PublicGetCompanyFundsHoldingsResponse
  - `results` union, required
    - CompanyFundHoldingsResults
      - `funds` CompanyFundHoldingsRow[], nullable, required — List of company fund holdings.
        - `rp_entity_id` string, nullable, required — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`)
        - `name` string, nullable, required — The name of the holding.
        - `rank` integer, nullable, required — The rank of the holding in the portfolio.
        - `market_value` integer, nullable, required — The market value of the holding.
        - `status` string, nullable, required — The status of the holding (e.g., increased, decreased).
        - `shares` integer, nullable, required — The number of shares held.
        - `shares_last` integer, nullable, required — The number of shares held in the last reporting period.
        - `shares_change` integer, nullable, required — The change in the number of shares held since the last reporting period.
        - `shares_change_percent` number, nullable, required — The percentage change in the number of shares held since the last reporting period.
        - `capital_flow` integer, nullable, required — The capital flow associated with the holding.
    - EmptyResponse
  - `metadata` PublicCompanyFundsHoldingsRequestMetadata — Metadata for the request. Includes the backend request.
    - `request_id` string, required
    - `timestamp` string
    - `rp_entity_id` string, nullable — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`)
    - `stock_name` string, nullable
    - `year` integer, nullable
    - `quarter` integer, nullable

---

[API](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api.md) · [All operations](https://skmtc.dev/bigdata/apis/bigdata-structured-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bigdata/bigdata-structured-data-api/revisions/18082de268c4/schema)