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

# ETF Holdings

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

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.net/the-unnatural-group--llc/apis/tradesignals-api.md) · [All operations](https://skmtc.net/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/the-unnatural-group--llc/tradesignals-api/versions/0b37cadfb125/schema)