Get ETF Holdings Data

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

{
  "data": [
    {
      "asset": "AAPL",
      "isin": "",
      "market_value": 42967423896,
      "name": "APPLE INC",
      "security_cusip": "037833100",
      "shares_number": 177105268,
      "symbol": "SPY",
      "updated_at": "2025-09-09 12:09:15",
      "weight_percentage": 6.504
    }
  ],
  "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>"
    ]
  },
  "pagination": "<unknown>",
  "request_id": "<string>",
  "success": true
}

ETF

Get ETF Holdings Data

Feature Overview OpenAPI JSON Spec 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

GET

etf

holdings

Get ETF Holdings Data

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

{
  "data": [
    {
      "asset": "AAPL",
      "isin": "",
      "market_value": 42967423896,
      "name": "APPLE INC",
      "security_cusip": "037833100",
      "shares_number": 177105268,
      "symbol": "SPY",
      "updated_at": "2025-09-09 12:09:15",
      "weight_percentage": 6.504
    }
  ],
  "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>"
    ]
  },
  "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

ETF symbol (uppercase, e.g., SPY, QQQ, IWM)

Response

Successfully retrieved ETF holdings data

data

object[]

Show child attributes

error

object

Show child attributes

pagination

any

request_id

string

success

boolean

Get ETF In/Outflow Data Get ETF Information