---
title: "ETF Holdings"
method: GET
path: "/api/etfs/{ticker}/holdings"
---

# ETF Holdings

`GET /api/etfs/{ticker}/holdings`

## Request

- Base URL: `https://api.unusualwhales.com`
- URL: `https://api.unusualwhales.com/api/etfs/{ticker}/holdings`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/docs/api/etfs/:ticker/holdings/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve holdings data for ETFs.  Filter by optional ETF symbol and date.

## Path parameters

- `ticker` string, required

## Response `200`

Successful response

- ETFHoldingsResponse
  - `data` ETFHolding[]
    - `avg30_volume` string: The average stock volume for the stock over the last 30 days.
    - `bearish_premium` string: The bearish premium is defined as (call premium bid side) + (put premium ask side).
    - `bullish_premium` string: The bullish premium is defined as (call premium ask side) + (put premium bid side).
    - `call_premium` string: The sum of the premium of all the call transactions that executed.
    - `call_volume` integer: The sum of the size of all the call transactions that executed.
    - `close` string: The closing price of the candle.
    - `has_options` boolean: Boolean flag indicating whether the company has options.
    - `high` string: The highest price of the candle.
    - `low` string: The lowest price of the candle.
    - `name` string: The name of the company.
    - `open` string: The opening price of the candle.
    - `prev_price` string: The previous trading day's stock price of the ticker.
    - `put_premium` string: The sum of the premium of all the put transactions that executed.
    - `put_volume` integer: The sum of the size of all the put transactions that executed.
    - `sector` 'Basic Materials' | 'Communication Services' | 'Consumer Cyclical' | 'Consumer Defensive' | 'Energy' | 'Financial Services' | 'Healthcare' | 'Industrials' | 'Real Estate' | 'Technology' | 'Utilities': The financial sector of the ticker. Empty if unknown or not applicable such as ETF/Index.
    - `ticker` string: The stock ticker.
    - `volume` integer: The volume of the ticker for the trading day.
    - `week_52_high` string: The 52-week high stock price of the ticker.
    - `week_52_low` string: The 52-week low stock price of the ticker.

## Other responses

- `400`: Invalid request
- `401`: Unauthorized

---

[API](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api.md) - [All operations](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/revisions/0b37cadfb125?raw)