# Holdings

`GET` `https://api.unusualwhales.com/api/etfs/{ticker}/holdings`

Returns the holdings of the ETF


## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `ticker` | SingleTicker | Yes | A single ticker |


## Response (200)

| Field | Type | Description |
|-------|------|-------------|
| `avg30_volume` | Stock Average 30 Day Volume | The avg stock volume for the stock last 30 days. |
| `bearish_premium` | Market General Bearish Premium | The bearish premium is defined as (call premium bid side) + (put premium ask side). |
| `bullish_premium` | Market General Bullish Premium | The bullish premium is defined as (call premium ask side) + (put premium bid side). |
| `call_premium` | Market General Call Premium | The sum of the premium of all the call transactions that executed. |
| `call_volume` | Market General Call Volume | The sum of the size of all the call transactions that executed. |
| `close` | Candle Close | The closing price of the candle. |
| `has_options` | Stock Has Options | Boolean flag whether the company has options. |
| `high` | Candle High | The highest price of the candle. |
| `low` | Candle Low | The lowest price of the candle. |
| `name` | Stock Company Name | The name of the company. |
| `open` | Candle Open | The opening price of the candle. |
| `prev_price` | Stock Prev Close Price | The previous trading day's stock price of the ticker. |
| `put_premium` | Market General Put Premium | The sum of the premium of all the put transactions that executed. |
| `put_volume` | Market General Put Volume | The sum of the size of all the put transactions that executed. |
| `sector` | Market General Sector | The financial sector of the ticker. Empty if unknown or not applicable such as ETF/Index. |
| `ticker` | Stock Ticker | The stock ticker. |
| `volume` | Stock Day Stock Volume | The volume of the ticker for the trading day. |
| `week_52_high` | Stock Week 52 High | The 52 week high stock price of the ticker. |
| `week_52_low` | Stock Week 52 low | The 52 week low stock price of the ticker. |


## Example

### curl

```bash
curl -X GET "https://api.unusualwhales.com/api/etfs/{ticker}/holdings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
```

### Python

```python
import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/etfs/{ticker}/holdings", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))
```

## Response Example

```json
{
  "data": [
    {
      "avg30_volume": "52433648",
      "bearish_premium": "32565174",
      "bullish_premium": "22987045",
      "call_premium": "45254976",
      "call_volume": 197685,
      "close": "194.84",
      "has_options": true,
      "high": "196.579",
      "low": "194.41",
      "name": "APPLE INC",
      "prev_price": "197.14",
      "put_premium": "16338631",
      "put_volume": 106773,
      "sector": "Technology",
      "shares": 169938760,
      "short_name": "APPLE",
      "ticker": "AAPL",
      "type": "stock",
      "volume": 12314310,
      "week52_high": "199.62",
      "week52_low": "123.15",
      "weight": "7.335"
    },
    {
      "avg30_volume": "30239291",
      "bearish_premium": "14318236",
      "bullish_premium": "14142305",
      "call_premium": "22499010",
      "call_volume": 48302,
      "close": "371.0",
      "has_options": true,
      "high": "371.0",
      "low": "368.73",
      "name": "MICROSOFT CORP",
      "prev_price": "369.36",
      "put_premium": "8688334",
      "put_volume": 35055,
      "sector": "Technology",
      "shares": 85913823,
      "short_name": "MICROSOFT",
      "ticker": "MSFT",
      "type": "stock",
      "volume": 3760724,
      "week52_high": "384.3",
      "week52_low": "216.98",
      "weight": "6.959"
    },
    {
      "avg30_volume": "51068229",
      "bearish_premium": "27305757",
      "bullish_premium": "37477652",
      "call_premium": "68914858",
      "call_volume": 243442,
      "close": "152.82",
      "has_options": true,
      "high": "152.9",
      "low": "150.09",
      "name": "AMAZON.COM INC",
      "prev_price": "149.6",
      "put_premium": "15242490",
      "put_volume": 86301,
      "sector": "Consumer Cyclical",
      "shares": 104991822,
      "short_name": "AMAZON ",
      "ticker": "AMZN",
      "type": "stock",
      "volume": 11285233,
      "week52_high": "150.57",
      "week52_low": "81.43",
      "weight": "3.44"
    }
  ]
}
```