Ownership

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

Request

Security: Bearer Auth Authorization: Bearer <token>

Path Parameters

ticker SingleTicker required

A single ticker

Example: AAPL

Query Parameters

limit Default 20 Max 100 Min 1 optional

How many items to return. Default: 20. Max: 100. Min: 1.

Example: 20 Default: 20

>= 1 <= 100

Responses

200 422 500

Response Body 200 OK

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.

Example: 0001548760

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.

Example: MARK ZUCKERBERG

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.

Try It GET

API Token

Path Parameters

ticker required

Query Parameters

limit Default 20 Max 100 Min 1

Request Sample

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

Response Example 200

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