Get Company Institution Holders Info

curl --request GET \
  --url https://data-tools.prd.arrays.org/api/v1/stocks/institution-holder \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://data-tools.prd.arrays.org/api/v1/stocks/institution-holder', 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://data-tools.prd.arrays.org/api/v1/stocks/institution-holder",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$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://data-tools.prd.arrays.org/api/v1/stocks/institution-holder"

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

	req.Header.Add("X-API-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://data-tools.prd.arrays.org/api/v1/stocks/institution-holder")

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

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "avg_price_paid": 17.65,
      "calendar_end_date": "2014-06-30",
      "change_in_market_value": 5250000,
      "change_in_market_value_percentage": 24.3056,
      "change_in_ownership": 0.0007,
      "change_in_ownership_percentage": 16.3377,
      "change_in_performance": -939186,
      "change_in_shares_number": 176300,
      "change_in_shares_number_percentage": 16.3399,
      "change_in_weight": 0.0066,
      "change_in_weight_percentage": 17.177,
      "cik": "0001126328",
      "filing_date": "2014-08-12",
      "first_added": "2005-12-31",
      "holding_period": 35,
      "industry_title": "SEMICONDUCTORS & RELATED DEVICES",
      "investment_discretion": "DFND",
      "investor_name": "PRINCIPAL FINANCIAL GROUP INC",
      "is_counted_for_performance": true,
      "is_new": false,
      "is_sold_out": false,
      "last_market_value": 21600000,
      "last_ownership": 0.0042,
      "last_performance": 2417356,
      "last_shares_number": 1078956,
      "last_weight": 0.0385,
      "market_value": 26850000,
      "observed_at": 1407902400,
      "ownership": 0.0048,
      "performance": 1478169,
      "performance_percentage": 6.8434,
      "put_call_share": "Share",
      "quarter_end_price": 21.39,
      "security_cusip": "874039100",
      "security_name": "TAIWAN SEMICONDUCTOR MFG LTD",
      "shares_number": 1255256,
      "shares_type": "SH",
      "symbol": "TSM",
      "type_of_security": "SPONSORED ADR",
      "weight": 0.0452
    }
  ],
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "metadata": "<unknown>",
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

{
  "data": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "metadata": "<unknown>",
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

{
  "data": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "metadata": "<unknown>",
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

Stock

Get Company Institution Holders Info

OpenAPI JSON Spec Retrieve institution holder information for a specified stock symbol. This endpoint provides detailed data about institutional investors holding the stock, including their positions, changes, and performance metrics.

Main Use Cases

Institutional Analysis: Analyze institutional investor positions and changes
Ownership Tracking: Track institutional ownership and concentration
Investment Research: Understand institutional investor behavior and trends
Risk Management: Assess institutional ownership concentration and changes

Response Data Structure

holders ([]CompanyHolderInfo): Array of institution holder information

CompanyHolderInfo fields:

calendar_end_date (string): Date of the holding record
cik (string): CIK identifier
filing_date (string): Filing date
investor_name (string): Name of the institutional investor
symbol (string): Stock symbol
security_name (string): Security name
type_of_security (string): Type of security
security_cusip (string): Security CUSIP
shares_type (string): Shares type
put_call_share (string): Put/Call/Share indicator
investment_discretion (string): Investment discretion type
industry_title (string): Industry title
weight (float64): Portfolio weight
last_weight (float64): Previous portfolio weight
change_in_weight (float64): Change in weight
change_in_weight_percentage (float64): Change in weight percentage
market_value (float64): Market value
last_market_value (float64): Previous market value
change_in_market_value (float64): Change in market value
change_in_market_value_percentage (float64): Change in market value percentage
shares_number (string): Number of shares held
last_shares_number (string): Previous number of shares held
change_in_shares_number (string): Change in shares number
change_in_shares_number_percentage (float64): Change in shares number percentage
quarter_end_price (float64): Quarter end price
avg_price_paid (float64): Average price paid
is_new (bool): Whether this is a new position
is_sold_out (bool): Whether position was sold out
ownership (float64): Ownership percentage
last_ownership (float64): Previous ownership percentage
change_in_ownership (float64): Change in ownership
change_in_ownership_percentage (float64): Change in ownership percentage
holding_period (int32): Holding period in quarters
first_added (string): First added date
performance (string): Performance value
performance_percentage (float64): Performance percentage
last_performance (string): Previous performance value
change_in_performance (string): Change in performance
is_counted_for_performance (bool): Whether counted for performance
observed_at (int64): Observed timestamp (seconds)

Query Parameters:

symbol: Stock symbol (required, uppercase, e.g., TSM, AAPL, MSFT)
start_time: Start time (required, Unix timestamp in seconds)
end_time: End time (required, Unix timestamp in seconds)
limit: Limit number of results (optional, default: 50, max: 5000)
time_type: Time type for filtering (required)
CALENDAR_END_DATE: Filter by Date (calendarEndDate) field
FILING_DATE: Filter by FilingDate field
OBSERVED_AT: Filter by publish_time field

GET

stocks

institution-holder

Get Company Institution Holders Info

curl --request GET \
  --url https://data-tools.prd.arrays.org/api/v1/stocks/institution-holder \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://data-tools.prd.arrays.org/api/v1/stocks/institution-holder', 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://data-tools.prd.arrays.org/api/v1/stocks/institution-holder",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$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://data-tools.prd.arrays.org/api/v1/stocks/institution-holder"

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

	req.Header.Add("X-API-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://data-tools.prd.arrays.org/api/v1/stocks/institution-holder")

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

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "avg_price_paid": 17.65,
      "calendar_end_date": "2014-06-30",
      "change_in_market_value": 5250000,
      "change_in_market_value_percentage": 24.3056,
      "change_in_ownership": 0.0007,
      "change_in_ownership_percentage": 16.3377,
      "change_in_performance": -939186,
      "change_in_shares_number": 176300,
      "change_in_shares_number_percentage": 16.3399,
      "change_in_weight": 0.0066,
      "change_in_weight_percentage": 17.177,
      "cik": "0001126328",
      "filing_date": "2014-08-12",
      "first_added": "2005-12-31",
      "holding_period": 35,
      "industry_title": "SEMICONDUCTORS & RELATED DEVICES",
      "investment_discretion": "DFND",
      "investor_name": "PRINCIPAL FINANCIAL GROUP INC",
      "is_counted_for_performance": true,
      "is_new": false,
      "is_sold_out": false,
      "last_market_value": 21600000,
      "last_ownership": 0.0042,
      "last_performance": 2417356,
      "last_shares_number": 1078956,
      "last_weight": 0.0385,
      "market_value": 26850000,
      "observed_at": 1407902400,
      "ownership": 0.0048,
      "performance": 1478169,
      "performance_percentage": 6.8434,
      "put_call_share": "Share",
      "quarter_end_price": 21.39,
      "security_cusip": "874039100",
      "security_name": "TAIWAN SEMICONDUCTOR MFG LTD",
      "shares_number": 1255256,
      "shares_type": "SH",
      "symbol": "TSM",
      "type_of_security": "SPONSORED ADR",
      "weight": 0.0452
    }
  ],
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "metadata": "<unknown>",
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

{
  "data": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "metadata": "<unknown>",
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

{
  "data": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "metadata": "<unknown>",
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

Authorizations

X-API-Key

string

header

required

API Key authentication. Example: "your-api-key-here"

Query Parameters

symbol

string

required

Stock symbol (uppercase, e.g., TSM, AAPL, MSFT)

limit

integer

Limit number of results (default: 50, max: 5000)

Required range: 1 <= x <= 5000

start_time

integer

required

Start time (Unix timestamp, required)

end_time

integer

required

End time (Unix timestamp, required)

time_type

enum<string>

required

Time type for filtering: 'CALENDAR_END_DATE' uses Date field, 'FILING_DATE' uses FilingDate field, 'OBSERVED_AT' uses publish_time field

Available options:

CALENDAR_END_DATE,

FILING_DATE,

OBSERVED_AT

Response

Successfully retrieved institution holder data

data

object[]

Show child attributes

error

object

Show child attributes

metadata

any

pagination

any

request_id

string

success

boolean

Overview

Endpoints

Get Company Institution Holders Info

Authorizations

Query Parameters

Response