Unusual Whales UnusualWhales API

Institutional Activity

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

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

ticker_symbol Ticker optional

A comma separated list of tickers. To exclude certain tickers prefix the first ticker with a `-`.

Example: AAPL,INTC
start_date Institutional Reporting Start Date optional

Start date to filter institutional reporting data in the format YYYY-MM-DD. Only data with dates on or after this date will be returned.

Example: 2023-01-01
end_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
Path Parameters
Query Parameters
Request Sample 
curl -X GET "https://api.unusualwhales.com/api/institution/{name}/activity/v2" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
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
    }
  ]
}