Institutional Activity (Deprecated)

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

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 Reporting End Date optional

End date to filter institutional reporting data in the format YYYY-MM-DD. Only data with dates 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

order Institutional Activity Order By optional

Optional columns to order the result by per report period end date.

Example: units Default: units

enum: units, units_change

order_direction OrderDirection optional

Whether to sort descending or ascending. Descending by default.

Example: asc Default: desc

enum: desc, asc

Responses

200 422 500

Response Body 200 OK

avg_price Avg Price

Example: 23.49

buy_price Buy Price

Example: 23.49

close Stock Close Price

The close stock price of the ticker.

Example: 182.91

filing_date General ISO Date

An ISO date.

Example: 2024-01-09

price_on_filing Price On Filing

The security price on the filing date.

Example: 23.49

price_on_report Price On Report

The security price on the report date.

Example: 23.49

put_call PutCall

Whether the holding is a put or a call (null if neither).

Example: put

report_date General ISO Date

An ISO date.

Example: 2024-01-09

security_type Security Type

Example: Share

sell_price Sell Price

Example: 23.49

shares_outstanding Shares Outstanding

Total outstanding shares for the ticker.

Example: 424295343.0

ticker Ticker Symbol

Example: MSFT

units Units

Example: 4103

units_change Units Change

The change in units

Example: -320

Try It GET

API Token

Path Parameters

name required

Query Parameters

date Institutional Reporting End Date

limit Default 500 Max 500 Min 1

page Page

order Institutional Activity Order By

order_direction OrderDirection

Request Sample

curl -X GET "https://api.unusualwhales.com/api/institution/{name}/activity" \
  -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}/activity", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "avg_price": "432.31",
      "buy_price": null,
      "close": "513.23",
      "filing_date": "2024-12-23",
      "price_on_filing": "510.34",
      "price_on_report": "495.95",
      "put_call": null,
      "report_date": "2024-09-30",
      "security_type": "Fund",
      "sell_price": null,
      "shares_outstanding": "148239423.0",
      "ticker": "SPLG",
      "units": 5000,
      "units_change": -500
    }
  ]
}