> ## 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 ETF Holdings Data > **Feature Overview** [OpenAPI JSON Spec](/docs/output/v1_etf_holdings_get.json) Retrieve detailed holdings information for a specified ETF symbol. This endpoint provides comprehensive data about the underlying assets held by the ETF, including weights, values, and portfolio composition. **Main Use Cases** - **Investment Analysis**: Analyze ETF portfolio composition and diversification - **Risk Assessment**: Evaluate concentration risk and sector allocation - **Performance Attribution**: Understand performance drivers through holdings analysis - **Portfolio Construction**: Use ETF holdings for asset allocation decisions - **Research Tools**: Academic and professional research on ETF structures **Response Data Structure** - `count` (int): Number of holdings returned - `data` ([]ETFHolding): Array of ETF holding items **ETFHolding fields:** - `symbol` (string): Holding stock symbol - `name` (string): Company or asset name - `shares` (int64): Number of shares held - `market_value` (float64): Total market value of holding - `weight` (float64): Percentage weight in portfolio - `sector` (string): Sector classification - `industry` (string): Industry classification - `country` (string): Country of incorporation - `asset_type` (string): Type of asset (Common Stock, Bond, etc.) - `price_per_share` (float64): Current price per share - `last_updated` (string): Last update date ## OpenAPI ````yaml /api-reference/openapi.json get /v1/etf/holdings 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/etf/holdings: get: tags: - ETF summary: Get ETF Holdings Data description: >- **Feature Overview** [OpenAPI JSON Spec](/docs/output/v1_etf_holdings_get.json) Retrieve detailed holdings information for a specified ETF symbol. This endpoint provides comprehensive data about the underlying assets held by the ETF, including weights, values, and portfolio composition. **Main Use Cases** - **Investment Analysis**: Analyze ETF portfolio composition and diversification - **Risk Assessment**: Evaluate concentration risk and sector allocation - **Performance Attribution**: Understand performance drivers through holdings analysis - **Portfolio Construction**: Use ETF holdings for asset allocation decisions - **Research Tools**: Academic and professional research on ETF structures **Response Data Structure** - `count` (int): Number of holdings returned - `data` ([]ETFHolding): Array of ETF holding items **ETFHolding fields:** - `symbol` (string): Holding stock symbol - `name` (string): Company or asset name - `shares` (int64): Number of shares held - `market_value` (float64): Total market value of holding - `weight` (float64): Percentage weight in portfolio - `sector` (string): Sector classification - `industry` (string): Industry classification - `country` (string): Country of incorporation - `asset_type` (string): Type of asset (Common Stock, Bond, etc.) - `price_per_share` (float64): Current price per share - `last_updated` (string): Last update date parameters: - description: ETF symbol (uppercase, e.g., SPY, QQQ, IWM) in: query name: symbol required: true schema: type: string responses: '200': description: Successfully retrieved ETF holdings data content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: items: $ref: '#/components/schemas/model.ETFHolding' 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.ETFHolding: properties: asset: example: AAPL type: string isin: example: '' type: string market_value: example: 42967423896 type: number name: example: APPLE INC type: string security_cusip: example: '037833100' type: string shares_number: example: 177105268 type: integer symbol: example: SPY type: string updated_at: description: Data update time, RFC3339 example: '2025-09-09T12:09:15Z' type: string weight_percentage: example: 6.504 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 ````