Sector Exposure

GET https://api.unusualwhales.com/api/institution/{name}/sectors

Request

Security: Bearer Auth Authorization: Bearer <token>

Path Parameters

name Institution required

A large entity that manages funds and investments for others. Queryable by name or cik.

Example: VANGUARD GROUP INC or 0000102909

Query Parameters

date Institutional Report End Date optional

A date in the format of YYYY-MM-DD, only institutional holdings with `report_date` values on or before this date will be returned.

Example: 2023-03-31

limit Default 500 Max 500 Min 1 optional

How many items to return. Default: 500. Max: 500. Min: 1.

Example: 10 Default: 500

>= 1 <= 500

page Page optional

Page number (use with limit). Starts on page 0.

Example: 1

Responses

200 422 500

Response Body 200 OK

positions Positions

Example: 5

positions_closed Positions Closed

Example: 2

positions_decreased Positions Decreased

Example: 2

positions_increased Positions Increased

Example: 2

report_date General ISO Date

An ISO date.

Example: 2024-01-09

sector Sector

A financial sector.

Example: Technology

value Value

The rounded total value on the reporting date.

Example: 2429329

Try It GET

API Token

Path Parameters

name required

Query Parameters

date Institutional Report End Date

limit Default 500 Max 500 Min 1

page Page

Request Sample

curl -X GET "https://api.unusualwhales.com/api/institution/{name}/sectors" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/institution/{name}/sectors", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "positions": 5,
      "positions_closed": 1,
      "positions_decreased": 1,
      "positions_increased": 2,
      "report_date": "2024-09-30",
      "sector": "Technology",
      "value": "1948023952"
    },
    {
      "positions": 7,
      "positions_closed": 4,
      "positions_decreased": 2,
      "positions_increased": 3,
      "report_date": "2024-09-30",
      "sector": "Basic Materials",
      "value": "43952"
    }
  ]
}