Retrieve Institutional Ownership
Returns the institutional ownership of a given ticker.
get/api/institution/{ticker}/ownership
Path parameters
tickerstring required
Example:AAPL,INTC
A comma-separated list of tickers. To exclude certain tickers, prefix the first ticker with a -.
Query parameters
datestring date
Example:2024-01-18T00:00:00.000Z
A trading date in the format of YYYY-MM-DD. Defaults to the last trading date if not provided.
limitinteger
Example:10
How many items to return. Default 500. Max 500. Min 1.
order'name' | 'short_name' | 'first_buy' | 'units' | 'units_change' | 'units_changed' | 'value' | 'avg_price' | 'perc_outstanding' | 'perc_units_changed' | 'activity' | 'perc_inst_value' | 'perc_share_value'
Example:name
Optional columns to order the result by.
order_direction'desc' | 'asc'
Example:asc
Whether to sort descending or ascending. Default is descending.
pageinteger
Example:1
Page number (use with limit). Starts on page 0.
tagsstring[]
An array of institution tags.
[ "activist" ]
Response
Successful response with institutional ownership data.
Example response
{
"data": [
{
"avg_price": "23.49",
"filing_date": "2024-12-23",
"first_buy": "2021-02-25",
"historical_units": [
4103,
4423
],
"inst_share_value": "2394292.0",
"inst_value": "1095205923.0",
"name": "VANGUARD GROUP INC",
"people": [
"John Doe"
],
"report_date": "2024-09-30",
"shares_outstanding": "148239423.0",
"short_name": "Vanguard",
"tags": [
"activist",
"value_investor"
],
"units": 5000,
"units_change": -500,
"value": 2934823
}
]
}