# Ownership

`GET` `https://api.unusualwhales.com/api/stock/{ticker}/ownership`

Returns the institutions, insider trades and politicians with the most shares.

This is an enterprise only endpoint. Contact dev@unusualwhales.com for details about accessing this data.


## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `ticker` | SingleTicker | Yes | A single ticker |

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `limit` | Default 20 Max 100 Min 1 | No | How many items to return. Default: 20. Max: 100. Min: 1. |


## Response (200)

| Field | Type | Description |
|-------|------|-------------|
| `cik` | Ownership CIK | The cik of the institution or insider trader owning the shares. Politicians don't have a CIK, so the field is empty for those. |
| `entity_type` | Ownership Entity Type | The type of entity owning the ticker shares. |
| `name` | Ownership Name | The name of the institution, insider trader or politician owning the shares. |
| `ownership` | Ownership Relative | The relative amount of ticker shares owned by the institution, insider trader or politician. |
| `ownership_perc` | Ownership Percentage | The percentage of ticker shares owned by the institution, insider trader or politician. |
| `units` | Ownership Units | The absolute amount of ticker shares owned by the institution, insider trader or politician. |


## Example

### curl

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

## Response Example

```json
{
  "data": [
    {
      "cik": "",
      "entity_type": "other",
      "name": "OTHER",
      "ownership": "0.5778598057824398968559314757",
      "ownership_perc": "57.79",
      "units": 1258514670
    },
    {
      "cik": "0001548760",
      "entity_type": "insider",
      "name": "ZUCKERBERG MARK",
      "ownership": "0.1573567903006183552668030525",
      "ownership_perc": "15.74",
      "units": 342705665
    },
    {
      "cik": "0000102909",
      "entity_type": "institution",
      "name": "VANGUARD GROUP INC",
      "ownership": "0.08849226346961719659402940931",
      "ownership_perc": "8.85",
      "units": 192726351
    },
    {
      "cik": "0002012383",
      "entity_type": "institution",
      "name": "BLACKROCK, INC.",
      "ownership": "0.07690733150859746487873438344",
      "ownership_perc": "7.69",
      "units": 167495652
    },
    {
      "cik": "0000315066",
      "entity_type": "institution",
      "name": "FMR LLC",
      "ownership": "0.05969144108951482234425757667",
      "ownership_perc": "5.97",
      "units": 130001349
    },
    {
      "cik": "0000093751",
      "entity_type": "institution",
      "name": "STATE STREET CORP",
      "ownership": "0.03969236784921226406024410234",
      "ownership_perc": "3.97",
      "units": 86445582
    }
  ]
}
```