> ## Documentation Index > Fetch the complete documentation index at: https://docs.arrays.org/llms.txt > Use this file to discover all available pages before exploring further. # Get Company Institution Holders Info > [OpenAPI JSON Spec](/docs/output/v1_stocks_institution-holder_get.json) 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 ## OpenAPI ````yaml /api-reference/openapi.json get /v1/stocks/institution-holder openapi: 3.0.0 info: contact: {} description: >- Welcome to Arrays! Arrays is a unified financial data layer for both financial institutions and retail users, delivering comprehensive market data across crypto and equity markets. Our datasets cover fundamentals, ETFs, options, crypto, and more. Visit [arrays.org](https://arrays.org) to request an API key and start your free trial. You can explore our full API offerings in the documentation below. For any questions regarding APIs or pricing, please contact support@arrays.org. title: Arrays API version: '1.0' servers: - url: https://data-tools.prd.arrays.org/api security: [] paths: /v1/stocks/institution-holder: get: tags: - Stock summary: Get Company Institution Holders Info description: >- [OpenAPI JSON Spec](/docs/output/v1_stocks_institution-holder_get.json) 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 parameters: - description: Stock symbol (uppercase, e.g., TSM, AAPL, MSFT) in: query name: symbol required: true schema: type: string - description: 'Limit number of results (default: 50, max: 5000)' in: query name: limit schema: type: integer minimum: 1 maximum: 5000 - description: Start time (Unix timestamp, required) in: query name: start_time required: true schema: type: integer - description: End time (Unix timestamp, required) in: query name: end_time required: true schema: type: integer - description: >- Time type for filtering: 'CALENDAR_END_DATE' uses Date field, 'FILING_DATE' uses FilingDate field, 'OBSERVED_AT' uses publish_time field in: query name: time_type required: true schema: type: string enum: - CALENDAR_END_DATE - FILING_DATE - OBSERVED_AT responses: '200': description: Successfully retrieved institution holder data content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: items: $ref: '#/components/schemas/model.CompanyHolderInfo' type: array type: object '400': description: Invalid parameters content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: $ref: '#/components/schemas/model.APIError' type: object '500': description: Internal server error content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: $ref: '#/components/schemas/model.APIError' type: object security: - ApiKeyAuth: [] components: schemas: model.APIResponse: properties: data: {} error: $ref: '#/components/schemas/model.APIError' metadata: {} pagination: {} request_id: type: string success: type: boolean type: object model.CompanyHolderInfo: properties: avg_price_paid: example: 17.65 type: number calendar_end_date: example: '2014-06-30' type: string change_in_market_value: example: 5250000 type: number change_in_market_value_percentage: example: 24.3056 type: number change_in_ownership: example: 0.0007 type: number change_in_ownership_percentage: example: 16.3377 type: number change_in_performance: example: -939186 type: integer change_in_shares_number: example: 176300 type: integer change_in_shares_number_percentage: example: 16.3399 type: number change_in_weight: example: 0.0066 type: number change_in_weight_percentage: example: 17.177 type: number cik: example: '0001126328' type: string filing_date: example: '2014-08-12' type: string first_added: example: '2005-12-31' type: string holding_period: example: 35 type: integer industry_title: example: SEMICONDUCTORS & RELATED DEVICES type: string investment_discretion: example: DFND type: string investor_name: example: PRINCIPAL FINANCIAL GROUP INC type: string is_counted_for_performance: example: true type: boolean is_new: example: false type: boolean is_sold_out: example: false type: boolean last_market_value: example: 21600000 type: number last_ownership: example: 0.0042 type: number last_performance: example: 2417356 type: integer last_shares_number: example: 1078956 type: integer last_weight: example: 0.0385 type: number market_value: example: 26850000 type: number observed_at: example: 1407902400 type: integer ownership: example: 0.0048 type: number performance: example: 1478169 type: integer performance_percentage: example: 6.8434 type: number put_call_share: example: Share type: string quarter_end_price: example: 21.39 type: number security_cusip: example: '874039100' type: string security_name: example: TAIWAN SEMICONDUCTOR MFG LTD type: string shares_number: example: 1255256 type: integer shares_type: example: SH type: string symbol: example: TSM type: string type_of_security: example: SPONSORED ADR type: string weight: example: 0.0452 type: number type: object model.APIError: properties: code: example: RESOURCE_NOT_FOUND type: string details: items: $ref: '#/components/schemas/model.APIErrorDetail' type: array docs_url: type: string examples: items: type: string type: array hint: type: string message: example: The requested resource was not found. type: string suggestions: items: type: string type: array type: object model.APIErrorDetail: properties: field: type: string got: type: string reason: type: string type: object securitySchemes: ApiKeyAuth: description: 'API Key authentication. Example: "your-api-key-here"' in: header name: X-API-Key type: apiKey ````