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

# Fund Holdings

`POST /v1/holdings/funds/stocks/`

Retrieve portfolio holdings disclosed by institutional funds in their SEC 13F filings. This dataset provides an overview of a fund’s positions, including the total number of holdings, overall portfolio size, and high-level summaries such as top holdings and allocation trends. It also allows retrieval of the top buys and sells for a fund or fund manager, either for the latest portfolio or for historical quarters. Sector composition of the fund’s portfolio can also be accessed.

## Request body

- PublicGetHoldingsOverviewQuery
  - `identifier` object, required — Object specifying which identifier you are using to request the fund holdings. You must supply one type and its corresponding value.
    - `type` 'rp_entity_id', required
    - `value` string, required — Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as asset managers and funds. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: BlackRock Inc. (`HJ95FV`)
  - `filters` HoldingsOverviewFilters
    - `year` integer, required — Fiscal year for the holdings data
    - `quarter` 1 | 2 | 3 | 4, required — Enum for quarters values.

## Response `200`

Successful Response

- PublicGetHoldingsOverviewResponse
  - `results` union, required
    - PublicGetHoldingsOverviewResult — Result object containing holdings list and portfolio summary data.
      - `holdings` PublicHolding[], required — List of holdings in the portfolio.
        - `rank` integer, required — The rank of the holding in the portfolio.
        - `rp_entity_id` string, nullable, required — RavenPack's internal entity identifier for the stock.
        - `ticker` string, required — The ticker symbol of the stock.
        - `name` string, required — The name of the stock.
        - `active` boolean, required — Whether the stock is active.
        - `market_value` integer, nullable — The market value of the holding.
        - `status` 'new' | 'increased' | 'maintained' | 'reduced' | 'closed', required
        - `portfolio_weight` number — The portfolio weight of the holding.
        - `shares` union — The number of shares held.
          - integer
          - number
        - `shares_last` union — The number of shares held in the last period.
          - integer
          - number
        - `shares_change` union — The change in the number of shares held.
          - integer
          - number
        - `shares_change_percent` number, nullable — The percentage change in the number of shares held.
        - `capital_flow` union — The capital flow of the holding.
          - integer
          - number
      - `quarter_return` number, nullable — The quarter return percentage.
      - `aum` integer, nullable — Assets under management.
      - `aum_last` integer, nullable — Assets under management in the last period.
      - `aum_change` integer, nullable — Change in assets under management.
      - `aum_change_percent` number, nullable — Percentage change in assets under management.
      - `aum_top_10` integer, nullable — Assets under management in top 10 holdings.
      - `aum_top_10_as_percent_of_aum` number, nullable — Top 10 holdings as percentage of total AUM.
      - `capital_flow` integer, nullable — Capital flow amount.
      - `capital_flow_as_percent_of_aum` number, nullable — Capital flow as percentage of AUM.
      - `etfs_percent` number, nullable — Percentage of portfolio in ETFs.
      - `turnover_percent` number, nullable — Portfolio turnover percentage.
      - `holdings_count` integer, nullable — Number of holdings.
      - `holdings_last` integer, nullable — Number of holdings in the last period.
      - `holdings_change` integer, nullable — Change in number of holdings.
      - `new_positions` integer, nullable — Number of new positions.
      - `new_positions_last` integer, nullable — Number of new positions in the last period.
      - `new_positions_change` integer, nullable — Change in number of new positions.
      - `closed_positions` integer, nullable — Number of closed positions.
      - `closed_positions_last` integer, nullable — Number of closed positions in the last period.
      - `closed_positions_change` integer, nullable — Change in number of closed positions.
      - `increased_positions` integer, nullable — Number of increased positions.
      - `increased_positions_last` integer, nullable — Number of increased positions in the last period.
      - `increased_positions_change` integer, nullable — Change in number of increased positions.
      - `reduced_positions` integer, nullable — Number of reduced positions.
      - `reduced_positions_last` integer, nullable — Number of reduced positions in the last period.
      - `reduced_positions_change` integer, nullable — Change in number of reduced positions.
      - `sector_composition` PublicSectorComposition[], nullable — Sector composition breakdown of the portfolio.
        - `sector` object, required
        - `percent` number, required
      - `top_transactions` PublicTopTransactions — Model for top buys and sells transactions.
        - `buys` PublicHolding[], required — List of top buys.
          - `rank` integer, required — The rank of the holding in the portfolio.
          - `rp_entity_id` string, nullable, required — RavenPack's internal entity identifier for the stock.
          - `ticker` string, required — The ticker symbol of the stock.
          - `name` string, required — The name of the stock.
          - `active` boolean, required — Whether the stock is active.
          - `market_value` integer, nullable — The market value of the holding.
          - `status` 'new' | 'increased' | 'maintained' | 'reduced' | 'closed', required
          - `portfolio_weight` number — The portfolio weight of the holding.
          - `shares` union — The number of shares held.
            - integer
            - number
          - `shares_last` union — The number of shares held in the last period.
            - integer
            - number
          - `shares_change` union — The change in the number of shares held.
            - integer
            - number
          - `shares_change_percent` number, nullable — The percentage change in the number of shares held.
          - `capital_flow` union — The capital flow of the holding.
            - integer
            - number
        - `sells` PublicHolding[], required — List of top sells.
          - `rank` integer, required — The rank of the holding in the portfolio.
          - `rp_entity_id` string, nullable, required — RavenPack's internal entity identifier for the stock.
          - `ticker` string, required — The ticker symbol of the stock.
          - `name` string, required — The name of the stock.
          - `active` boolean, required — Whether the stock is active.
          - `market_value` integer, nullable — The market value of the holding.
          - `status` 'new' | 'increased' | 'maintained' | 'reduced' | 'closed', required
          - `portfolio_weight` number — The portfolio weight of the holding.
          - `shares` union — The number of shares held.
            - integer
            - number
          - `shares_last` union — The number of shares held in the last period.
            - integer
            - number
          - `shares_change` union — The change in the number of shares held.
            - integer
            - number
          - `shares_change_percent` number, nullable — The percentage change in the number of shares held.
          - `capital_flow` union — The capital flow of the holding.
            - integer
            - number
    - EmptyResponse
  - `errors` ErrorDetail[], nullable
    - `message` string, nullable
  - `metadata` PublicHoldingsRequestMetadata, required — 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`)
    - `fund_name` string, nullable
    - `fiscal_year` integer, nullable
    - `fiscal_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)