---
title: "Top institutional buyers and sellers of an exact stock or ETF listing — biggest absolute share additions and reductions versus the previous 13F report date, including new and sold-out positions. Movement is like-for-like: only filers with an observed 13F in both quarters rank, so a fund that has not filed yet, a first filer or a fund that stopped filing under its CIK is never read as a trade, and note names the largest filers left out. A filer that continues under one new CIK is compared through it (continuesFrom); one split across several new CIKs is left out. Movement needs the immediately preceding quarter on record; otherwise note says the comparison is unavailable. Share counts are restated onto today's split basis."
method: GET
path: "/v1/stocks/{ticker}/institutional-activity"
tags: ["Holdings"]
---

# Top institutional buyers and sellers of an exact stock or ETF listing — biggest absolute share additions and reductions versus the previous 13F report date, including new and sold-out positions. Movement is like-for-like: only filers with an observed 13F in both quarters rank, so a fund that has not filed yet, a first filer or a fund that stopped filing under its CIK is never read as a trade, and note names the largest filers left out. A filer that continues under one new CIK is compared through it (continuesFrom); one split across several new CIKs is left out. Movement needs the immediately preceding quarter on record; otherwise note says the comparison is unavailable. Share counts are restated onto today's split basis.

`GET /v1/stocks/{ticker}/institutional-activity`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/stocks/{ticker}/institutional-activity`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/stocks/:ticker/institutional-activity/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `ticker` string, required

## Query parameters

- `reportDate` string, date
- `limit` integer

## Response `200`

OK

- HoldingsActivityResponse
  - `listingNotice` ListingNotice: What happened to a requested ticker that no longer trades. "delisted": the company has no current US listing, so the answer is its history. "renamed": the company now trades as successorTicker, its current US presentation ticker (possibly another share class). A listed series (short volume, short interest, off-exchange volume, fails-to-deliver, congressional trades) is the retired ticker's own; a company-level read is the company's data.
    - `status` string, nullable: "delisted" or "renamed".
    - `ticker` string, nullable: The retired ticker as listed.
    - `delistedOn` string, date, nullable: The day the retired listing stopped trading, when known.
    - `successorTicker` string, nullable: For "renamed", the company's current US presentation ticker; null for "delisted".
  - `reportDate` string, date
  - `previousReportDate` string, date, nullable: The 13F quarter on record before the target; null when the target quarter is the oldest on record. Movement is reported only when it is the immediately preceding quarter; otherwise note says the comparison is unavailable.
  - `isFilingWindowOpen` boolean: True while the target quarter's 13F filing window is still open; most filers left out then simply have not filed yet.
  - `buyers` HolderActivityDto[], nullable: Buyers and sellers are compared like-for-like: only filers with an observed 13F in both quarters rank, so a late filer, a first filer or a fund that stopped filing under its CIK is never read as a trade. A filer that continues under one new CIK is compared through it (continuesFrom); one split across several new CIKs is left out.
    - `name` string, nullable
    - `cik` string, nullable: SEC CIK of the institution — the identifier accepted by the v1/institutions/{cik}/* endpoints.
    - `previousShares` integer: Prior-quarter share count, restated onto today's split basis.
    - `currentShares` integer: Target-quarter share count, restated onto today's split basis.
    - `deltaShares` integer: Share-count change across the two quarters on today's split basis, so it reflects a real position change rather than a split.
    - `deltaValue` integer: Change in published position value in dollars. Values normally use the report-date closing-price basis, may fall back to the filer's value, and can be zero when unavailable; the delta includes price movement, so a seller can still show a positive value change.
    - `isNewPosition` boolean: True when the institution reported no position in the prior quarter (the delta is the full position).
    - `isSoldOut` boolean: True when the institution exited entirely this quarter (the delta is the negated prior position).
    - `isFirst13F` boolean, nullable: For new-position buyers only: true when the target quarter is the filer's first 13F on record. A first-time filer ranks only when it continues an earlier CIK (see continuesFrom). Null when the row is not a new position.
    - `continuesFrom` ContinuedFilerDto[], nullable: The earlier filers this CIK alone continues, whose previous-quarter positions are included in previousShares (additive). Omitted for any other row.
      - `name` string, nullable
      - `cik` string, nullable: SEC CIK of the earlier filer.
  - `sellers` HolderActivityDto[], nullable
    - `name` string, nullable
    - `cik` string, nullable: SEC CIK of the institution — the identifier accepted by the v1/institutions/{cik}/* endpoints.
    - `previousShares` integer: Prior-quarter share count, restated onto today's split basis.
    - `currentShares` integer: Target-quarter share count, restated onto today's split basis.
    - `deltaShares` integer: Share-count change across the two quarters on today's split basis, so it reflects a real position change rather than a split.
    - `deltaValue` integer: Change in published position value in dollars. Values normally use the report-date closing-price basis, may fall back to the filer's value, and can be zero when unavailable; the delta includes price movement, so a seller can still show a positive value change.
    - `isNewPosition` boolean: True when the institution reported no position in the prior quarter (the delta is the full position).
    - `isSoldOut` boolean: True when the institution exited entirely this quarter (the delta is the negated prior position).
    - `isFirst13F` boolean, nullable: For new-position buyers only: true when the target quarter is the filer's first 13F on record. A first-time filer ranks only when it continues an earlier CIK (see continuesFrom). Null when the row is not a new position.
    - `continuesFrom` ContinuedFilerDto[], nullable: The earlier filers this CIK alone continues, whose previous-quarter positions are included in previousShares (additive). Omitted for any other row.
      - `name` string, nullable
      - `cik` string, nullable: SEC CIK of the earlier filer.
  - `limit` integer, nullable: The applied per-side cap — a side is truncated whenever its total below exceeds its list length (additive, #7056).
  - `totalBuyers` integer, nullable: Total buyers before the cap (additive, #7056).
  - `totalSellers` integer, nullable: Total sellers before the cap (additive, #7056).
  - `note` string, nullable: Why rows are missing (additive): the filers left out of the comparison with their shares and the largest by name, the CIK changes compared across, or why no comparison was possible. Omitted when there is nothing to say.

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/666e06778588?raw)