# Institutional Activity

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

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


## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `name` | Institution | Yes | A large entity that manages funds and investments for others. Queryable by name or cik. |

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `ticker_symbol` | Ticker | No | A comma separated list of tickers. To exclude certain tickers prefix the first ticker with a `-`. |
| `start_date` | Institutional Reporting Start Date | No | 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.
 |
| `end_date` | Institutional Reporting End Date | No | 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.
 |
| `limit` | Default 500 Max 500 Min 1 | No | How many items to return. Default: 500. Max: 500. Min: 1. |
| `page` | Page | No | Page number (use with limit). Starts on page 0. |
| `order` | Institutional Activity Order By | No | Optional columns to order the result by per report period end date. |
| `order_direction` | OrderDirection | No | Whether to sort descending or ascending. Descending by default. |


## Response (200)

| Field | Type | Description |
|-------|------|-------------|
| `avg_price` | Avg Price |  |
| `buy_price` | Buy Price |  |
| `close` | Stock Close Price | The close stock price of the ticker. |
| `filing_date` | General ISO Date | An ISO date. |
| `price_on_filing` | Price On Filing | The security price on the filing date. |
| `price_on_report` | Price On Report | The security price on the report date. |
| `put_call` | PutCall | Whether the holding is a put or a call (null if neither). |
| `report_date` | General ISO Date | An ISO date. |
| `security_type` | Security Type |  |
| `sell_price` | Sell Price |  |
| `shares_outstanding` | Shares Outstanding | Total outstanding shares for the ticker. |
| `ticker` | Ticker Symbol |  |
| `units` | Units |  |
| `units_change` | Units Change | The change in units |


## Example

### curl

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

### Python

```python
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/v2", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))
```

## Response Example

```json
{
  "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
    }
  ]
}
```