Institutional Activity
The trading activities for a given institution.
If the result contains multiple report periods, it will contain first the latest report period results ordered by the order and order_direction,
then the second latest report period ordered by the order and order_direction and so on, e.g. first all results for report period 2025-09-30, then
all results for report period 2025-06-30 …
Per default the results per report period will be ordered by units descending.
If you provide the same date for start_date and end_date you will only get the results for filings with that date as the report period end date
e.g. if you set start_date and end_date to 2025-09-30 you will only get the results for the report period ending on 2025-09-30.
WARNING: Providing partial names e.g. “VANGUARD” might lead to unexpected results. To ensure you get the expected result, it is recommended to use the company CIK (e.g. 0000102909 for VANGUARD GROUP INC) as the name parameter.
You can use endpoint “api/institutions” with a partial name like “VANGUARD” to get all matching institutions with their CIKs.
If you are looking to build a database of insitutional positions use https://unusualwhales.com/skills/institutional.md
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
A large entity that manages funds and investments for others. Queryable by name or cik.
"VANGUARD GROUP INC or 0000102909"
Query Parameters
A comma separated list of tickers. To exclude certain tickers prefix the first ticker with a -.
"AAPL,INTC"
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.
"2023-01-01T00:00:00.000Z"
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.
"2023-03-31T00:00:00.000Z"
How many items to return. Max: 500. Min: 1. Returns up to 500 when omitted.
1 <= x <= 50010
Page number (use with limit). Starts on page 0.
1
Optional columns to order the result by per report period end date.
units, units_change "units"
Whether to sort descending or ascending. Descending by default.
desc, asc "asc"
Response
The trading activities for a given institution.
"23.49"
"23.49"
The close stock price of the ticker.
"182.91"
An ISO date.
"2024-01-09T00:00:00.000Z"
The security price on the filing date.
"23.49"
The security price on the report date.
"23.49"
Whether the holding is a put or a call (null if neither).
"put"
An ISO date.
"2024-01-09T00:00:00.000Z"
"Share"
"23.49"
Total outstanding shares for the ticker.
"424295343.0"
"MSFT"
4103
The change in units
-320
