Skip to main content
GET
/
v1
/
institutional
/
ownership
Get Institutional Ownership
curl --request GET \
  --url https://api.aries.com/v1/institutional/ownership \
  --header 'Authorization: Bearer <token>'
import requests

url = "https://api.aries.com/v1/institutional/ownership"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aries.com/v1/institutional/ownership', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/institutional/ownership",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.aries.com/v1/institutional/ownership"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "Bearer <token>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/institutional/ownership")
.header("Authorization", "Bearer <token>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.aries.com/v1/institutional/ownership")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "data": [
    {
      "symbol": "TSLA",
      "cusip": "023135106",
      "name": "Worth Asset Management, LLC",
      "share": 1743,
      "change": -57,
      "value": 197000,
      "putCall": ""
    }
  ]
}

Authorizations

Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

cusip
string
required

CUSIP security identifier for the security you want institutional ownership for.

Example:

"023135106"

from
string<date>
required

Start date in YYYY-MM-DD format. Enter the first date to include in the research window.

Example:

"2024-01-01"

to
string<date>
required

End date in YYYY-MM-DD format. Enter the last date to include in the research window.

Example:

"2024-12-31"

symbol
string

Optional stock ticker symbol filter, such as AAPL. Use it to narrow results to one company.

Example:

"TSLA"

Response

Institutional ownership data.

data
object[]

List of institutional ownership records for a security