Sector Etfs - Unusual Whales Docs

Sector Etfs

curl --request GET \
  --url https://api.unusualwhales.com/api/market/sector-etfs \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.unusualwhales.com/api/market/sector-etfs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unusualwhales.com/api/market/sector-etfs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.unusualwhales.com/api/market/sector-etfs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.unusualwhales.com/api/market/sector-etfs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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-07T00:00:00.000Z",
      "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-07T00:00:00.000Z",
      "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-07T00:00:00.000Z",
      "put_premium": "261697",
      "put_volume": 1048,
      "ticker": "XLC",
      "volume": 1435724,
      "week52_high": "69.22",
      "week52_low": "44.63"
    }
  ]
}

{
  "code": "authentication_required",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "expected_format": "uuid",
  "message": "The API token provided is not in the expected format. Unusual Whales API tokens are UUIDs, such as 123e4567-e89b-12d3-a456-426614174000.",
  "reason": "malformed_token",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "code": "payment_required",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "message": "This API token is paused because the payment for your API subscription failed. Update your card at https://unusualwhales.com/settings. The same token works again once a payment succeeds.",
  "reason": "payment_failed",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "code": "missing_access",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "message": "The API token provided is valid but is not permitted to access this route.",
  "reason": "route_not_permitted",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

Something went wrong

GET

api

market

sector-etfs

Sector Etfs

curl --request GET \
  --url https://api.unusualwhales.com/api/market/sector-etfs \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.unusualwhales.com/api/market/sector-etfs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.unusualwhales.com/api/market/sector-etfs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.unusualwhales.com/api/market/sector-etfs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.unusualwhales.com/api/market/sector-etfs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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-07T00:00:00.000Z",
      "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-07T00:00:00.000Z",
      "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-07T00:00:00.000Z",
      "put_premium": "261697",
      "put_volume": 1048,
      "ticker": "XLC",
      "volume": 1435724,
      "week52_high": "69.22",
      "week52_low": "44.63"
    }
  ]
}

{
  "code": "authentication_required",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "expected_format": "uuid",
  "message": "The API token provided is not in the expected format. Unusual Whales API tokens are UUIDs, such as 123e4567-e89b-12d3-a456-426614174000.",
  "reason": "malformed_token",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "code": "payment_required",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "message": "This API token is paused because the payment for your API subscription failed. Update your card at https://unusualwhales.com/settings. The same token works again once a payment succeeds.",
  "reason": "payment_failed",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

{
  "code": "missing_access",
  "documentation_url": "https://api.unusualwhales.com/docs",
  "message": "The API token provided is valid but is not permitted to access this route.",
  "reason": "route_not_permitted",
  "request_id": "GNI_YTC1CRnw2LACGBvE",
  "retryable": false,
  "support_email": "[email protected]",
  "token_url": "https://unusualwhales.com/dashboard/api"
}

Something went wrong

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

avg30_stock_volume

string

Avg 30 day stock volume.

Example:

"74402355"

avg_30_day_call_volume

string

Avg 30 day call volume.

Example:

"679430.000000000000"

avg_30_day_put_volume

string

Avg 30 day put volume.

Example:

"401961.285714285714"

avg_7_day_call_volume

string

Avg 7 day call volume.

Example:

"679145.333333333333"

avg_7_day_put_volume

string

Avg 7 day put volume.

Example:

"388676.000000000000"

bearish_premium

string

The bearish premium is defined as (call premium bid side) + (put premium ask side).

Example:

"143198625"

bullish_premium

string

The bullish premium is defined as (call premium ask side) + (put premium bid side).

Example:

"196261414"

call_premium

string

The sum of the premium of all the call transactions that executed.

Example:

"9908777.0"

call_volume

integer

The sum of the size of all the call transactions that executed.

Example:

990943

string

The closing price of the candle.

Example:

"56.79"

full_name

string

The name/sector of the SPDR sector ETF.

Example:

"S&P 500 Index"

high

string

The highest price of the candle.

Example:

"58.12"

low

string

The lowest price of the candle.

Example:

"51.90"

marketcap

string

The marketcap of the underlying ticker. If the issue type of the ticker is ETF then the marketcap represents the AUM.

Example:

"2965813810400"

open

string

The opening price of the candle.

Example:

"54.29"

prev_close

string

The previous trading day's stock price of the ticker.

Example:

"189.70"

prev_date

string

The date of the previous trading day in ISO format.

Example:

"2023-09-07T00:00:00.000Z"

put_premium

string

The sum of the premium of all the put transactions that executed.

Example:

"163537151"

put_volume

integer

The sum of the size of all the put transactions that executed.

Example:

808326

ticker

string

The stock ticker.

Example:

"AAPL"

volume

integer

The volume of the ticker for the trading day.

Example:

23132119

week_52_high

string

The 52 week high stock price of the ticker.

Example:

"198.23"

week_52_low

string

The 52 week low stock price of the ticker.

Example:

"124.17"