---
title: "Retrieve Institutional Holdings"
method: GET
path: "/api/institution/{name}/holdings"
---

# Retrieve Institutional Holdings

`GET /api/institution/{name}/holdings`

Returns the holdings for a given institution.

## Path parameters

- `name` string, required

## Query parameters

- `date` string, date
- `limit` integer
- `order` 'date' | 'ticker' | 'security_type' | 'put_call' | 'first_buy' | 'price_first_buy' | 'units' | 'units_change' | 'historical_units' | 'value' | 'avg_price' | 'close' | 'shares_outstanding'
- `order_direction` 'desc' | 'asc'
- `page` integer
- `security_types` string[]

## Response `200`

Successful response with institutional holdings data.

- InstitutionHoldingsResponse
  - `data` InstitutionHolding[]
    - `avg_price` string — Average price of the security.
    - `close` string — The latest stock price of the ticker.
    - `date` string, date — The date for the holding.
    - `first_buy` string, date — The date of the first purchase.
    - `full_name` string — Full name of the company.
    - `historical_units` integer[] — Historical unit counts (max length 8).
    - `price_first_buy` string — Close price of the ticker on the first buy date.
    - `put_call` string, nullable — Whether the holding is a put or a call (null if neither).
    - `sector` string — Sector of the company.
    - `security_type` string — Type of the security (e.g., Share, Fund).
    - `shares_outstanding` string — Total outstanding shares for the ticker.
    - `ticker` string — Stock ticker symbol.
    - `units` integer — Number of units held.
    - `units_change` integer — Change in units held.
    - `value` integer — The rounded total value on the reporting date.

## Other responses

- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/the-unnatural-group--llc/apis/tradesignals-api.md) · [All operations](https://skmtc.net/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/the-unnatural-group--llc/tradesignals-api/revisions/0b37cadfb125/schema)