Get ETF Country Weightings

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

{
  "data": [
    {
      "country": "United States",
      "weight_percentage": "99.56%"
    }
  ],
  "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 Country Weightings

Feature Overview OpenAPI JSON Spec Retrieve country allocation information for a specified ETF symbol. This endpoint provides detailed breakdown of the ETF’s geographic exposure by country and their respective weight percentages.

Main Use Cases

Geographic Analysis: Analyze ETF’s country diversification and concentration
Risk Assessment: Evaluate country-specific risk exposure
Portfolio Construction: Use country weightings for geographic asset allocation
Investment Research: Understand ETF’s geographic distribution
Compliance Monitoring: Track country exposure limits and regulations

Response Data Structure

weightings ([]CountryWeighting): Array of country weighting items

CountryWeighting fields:

country (string): Country name
weight_percentage (string): Percentage weight as string (e.g., “99.56%”)

GET

etf

country-weightings

Get ETF Country Weightings

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

{
  "data": [
    {
      "country": "United States",
      "weight_percentage": "99.56%"
    }
  ],
  "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 country weightings

data

object[]

Show child attributes

error

object

Show child attributes

pagination

any

request_id

string

success

boolean

Get Token Unlock Events Get ETF In/Outflow Data