# Sector Etfs

`GET` `https://api.unusualwhales.com/api/market/sector-etfs`

Returns the current trading days statistics for the SPDR sector etfs.

If you are interested in building some sort of market dashboard and want to quickly
retrieve which sectors are up/down today this endpoint returns all required data to build
such dashboard/view.

----
This can be used to build a market overview such as:

![sectors etf](https://i.imgur.com/yQ5o6rR.png)


## Authentication

```
Authorization: Bearer YOUR_API_KEY
```


## Response (200)

| Field | Type | Description |
|-------|------|-------------|
| `avg30_stock_volume` | Market General Avg 30 Day Stock Volume | Avg 30 day stock volume. |
| `avg_30_day_call_volume` | Market General Avg 30 Day Call Volume | Avg 30 day call volume. |
| `avg_30_day_put_volume` | Market General Avg 30 Day Put Volume | Avg 30 day put volume. |
| `avg_7_day_call_volume` | Market General Avg 7 Day Call Volume | Avg 7 day call volume. |
| `avg_7_day_put_volume` | Market General Avg 7 Day Put Volume | Avg 7 day put volume. |
| `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. |
| `full_name` | Etf Sector Full Name | The name/sector of the SPDR sector ETF. |
| `high` | Candle High | The highest price of the candle. |
| `low` | Candle Low | The lowest price of the candle. |
| `marketcap` | Stock Marketcap AUM | The marketcap of the underlying ticker. If the issue type of the ticker is ETF then the marketcap represents the AUM. |
| `open` | Candle Open | The opening price of the candle. |
| `prev_close` | Stock Prev Close Price | The previous trading day's stock price of the ticker. |
| `prev_date` | Market General Previous Trading Day | The date of the previous trading day in ISO format. |
| `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. |
| `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/market/sector-etfs" \
  -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/market/sector-etfs", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))
```

## Response Example

```json
{
  "data": [
    {
      "avg30_call_volume": "3636459.000000000000",
      "avg30_put_volume": "4796289.166666666667",
      "avg30_stock_volume": "74402355",
      "avg_30_day_call_volume": "3636459.000000000000",
      "avg_30_day_put_volume": "4796289.166666666667",
      "avg_7_day_call_volume": "3343061.285714285714",
      "avg_7_day_put_volume": "4521616.428571428571",
      "bearish_premium": "258905527",
      "bullish_premium": "238729761",
      "call_premium": "293824502",
      "call_volume": 1844830,
      "full_name": "S&P 500 Index",
      "high": "447.11",
      "last": "446.15",
      "low": "444.8",
      "marketcap": "406517275500",
      "open": "444.93",
      "prev_close": "444.85",
      "prev_date": "2023-09-07",
      "put_premium": "244159205",
      "put_volume": 2009005,
      "ticker": "SPY",
      "volume": 23132119,
      "week52_high": "459.44",
      "week52_low": "342.65"
    },
    {
      "avg30_call_volume": "1574.3333333333333333",
      "avg30_put_volume": "2571.6000000000000000",
      "avg30_stock_volume": "4773693",
      "avg_30_day_call_volume": "1574.3333333333333333",
      "avg_30_day_put_volume": "2571.6000000000000000",
      "avg_7_day_call_volume": "2003.0000000000000000",
      "avg_7_day_put_volume": "1208.2857142857142857",
      "bearish_premium": "25852",
      "bullish_premium": "30558",
      "call_premium": "37618",
      "call_volume": 319,
      "full_name": "Materials",
      "high": "82.145",
      "last": "81.96",
      "low": "81.55",
      "marketcap": "5607626400",
      "open": "81.67",
      "prev_close": "81.72",
      "prev_date": "2023-09-07",
      "put_premium": "27107",
      "put_volume": 250,
      "ticker": "XLB",
      "volume": 1582879,
      "week52_high": "85.86",
      "week52_low": "66.13"
    },
    {
      "avg30_call_volume": "2020.4000000000000000",
      "avg30_put_volume": "1831.2000000000000000",
      "avg30_stock_volume": "5018213",
      "avg_30_day_call_volume": "2020.4000000000000000",
      "avg_30_day_put_volume": "1831.2000000000000000",
      "avg_7_day_call_volume": "1677.2857142857142857",
      "avg_7_day_put_volume": "2283.4285714285714286",
      "bearish_premium": "524756",
      "bullish_premium": "249626",
      "call_premium": "711775",
      "call_volume": 855,
      "full_name": "Communication Services",
      "high": "67.26",
      "last": "67.08",
      "low": "66.78",
      "marketcap": "14026276000",
      "open": "66.78",
      "prev_close": "66.76",
      "prev_date": "2023-09-07",
      "put_premium": "261697",
      "put_volume": 1048,
      "ticker": "XLC",
      "volume": 1435724,
      "week52_high": "69.22",
      "week52_low": "44.63"
    }
  ]
}
```