---
title: "GET /etf-global/v1/constituents"
method: GET
path: "/etf-global/v1/constituents"
tags: ["etfglobal"]
---

# GET /etf-global/v1/constituents

`GET /etf-global/v1/constituents`

ETF Global constituents data containing detailed information about the securities held within ETFs, including weights, market values, and security identifiers.

## Query parameters

- `composite_ticker` string
- `composite_ticker.any_of` string
- `composite_ticker.gt` string
- `composite_ticker.gte` string
- `composite_ticker.lt` string
- `composite_ticker.lte` string
- `constituent_ticker` string
- `constituent_ticker.any_of` string
- `constituent_ticker.gt` string
- `constituent_ticker.gte` string
- `constituent_ticker.lt` string
- `constituent_ticker.lte` string
- `effective_date` string
- `effective_date.gt` string
- `effective_date.gte` string
- `effective_date.lt` string
- `effective_date.lte` string
- `processed_date` string
- `processed_date.gt` string
- `processed_date.gte` string
- `processed_date.lt` string
- `processed_date.lte` string
- `us_code` string
- `us_code.any_of` string
- `us_code.gt` string
- `us_code.gte` string
- `us_code.lt` string
- `us_code.lte` string
- `isin` string
- `isin.any_of` string
- `isin.gt` string
- `isin.gte` string
- `isin.lt` string
- `isin.lte` string
- `figi` string
- `figi.any_of` string
- `figi.gt` string
- `figi.gte` string
- `figi.lt` string
- `figi.lte` string
- `sedol` string
- `sedol.any_of` string
- `sedol.gt` string
- `sedol.gte` string
- `sedol.lt` string
- `sedol.lte` string
- `limit` integer
- `sort` string

## Response `200`

A list of results.

- object
  - `next_url` string — If present, this value can be used to fetch the next page.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object[], required — The results for this request.
    - `asset_class` string — The broad category of asset type, such as Equity, Corporate Bond, Municipal Bond, etc.
    - `composite_ticker` string — The stock ticker symbol of the ETF that holds these constituent securities.
    - `constituent_name` string — The full company or security name of the constituent holding.
    - `constituent_rank` integer, required — The rank of this constituent within the ETF for a given effective_date, ordered by weight (descending), market_value (descending), and constituent_ticker (ascending). A rank of 1 indicates the largest holding.
    - `constituent_ticker` string — The stock ticker symbol of the individual security held within the ETF.
    - `country_of_exchange` string — The country where the exchange that lists this constituent security is located.
    - `currency_traded` string — The local currency in which this constituent security is denominated and traded.
    - `effective_date` string, date, required — The date showing when the information was accurate or valid; some issuers, such as Vanguard, release their data on a delay, so the effective_date can be several weeks earlier than the processed_date.
    - `exchange` string — The name of the stock exchange where this constituent security is primarily traded.
    - `figi` string — The Financial Instrument Global Identifier, an open standard for uniquely identifying financial instruments.
    - `isin` string — The International Securities Identification Number, a global standard for identifying securities.
    - `market_value` number, double — The total market value of this constituent position held by the ETF.
    - `processed_date` string, date — The date showing when ETF Global received and processed the data.
    - `security_type` string — The specific classification of security type using ETF Global's taxonomy, such as Common Equity, Domestic, Global, etc.
    - `sedol` string — The Stock Exchange Daily Official List code, primarily used for securities trading in the UK.
    - `shares_held` number, double — The number of shares of this constituent security that the ETF currently owns.
    - `us_code` string — A unique identifier code for the constituent security in US markets.
    - `weight` number, double — The percentage weight of this constituent security within the ETF's total portfolio.
  - `status` 'OK', required — The status of this request's response.

## Other responses

- `400` — An error message.

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)