---
title: "Retrieve Sector Exposure"
method: GET
path: "/api/institution/{name}/sectors"
---

# Retrieve Sector Exposure

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

## Request

- Base URL: `https://api.unusualwhales.com`
- URL: `https://api.unusualwhales.com/api/institution/{name}/sectors`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/docs/api/institution/:name/sectors/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the sector exposure for a given institution.

## Path parameters

- `name` string, required

## Query parameters

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

## Response `200`

Successful response with sector exposure data.

- SectorExposureResponse
  - `data` SectorExposure[]
    - `positions` integer: Number of positions in the sector.
    - `positions_closed` integer: Number of closed positions in the sector.
    - `positions_decreased` integer: Number of decreased positions in the sector.
    - `positions_increased` integer: Number of increased positions in the sector.
    - `report_date` string, date: Report date for the exposure.
    - `sector` string: Name of the sector.
    - `value` integer: Rounded total value of the sector on the reporting date.

## Other responses

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

---

[API](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api.md) - [All operations](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/revisions/0b37cadfb125?raw)