Month Performers

GET https://api.unusualwhales.com/api/seasonality/{month}/performers

Request

Security: Bearer Auth Authorization: Bearer <token>

Path Parameters

month SingleMonthNumber required

A month number indicating the month, e.g. 1 -> January, 2 -> February, ...

Example: 3

enum: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12

Query Parameters

min_years Min Years optional

The minimum amount of years data for the month need to be available for the ticker. Default: 10. Min: 1.

Example: 3 Default: 10

>= 1

ticker_for_sector SingleTickerForSector optional

A single ticker. The result will only contain tickers in the same sector as the given ticker, e.g. 'MSFT' will only yield result tickers in sector 'Technology'.

Example: AAPL

s_p_500_nasdaq_only Nasdaq Only optional

min_oi Min Open Interest optional

The minimum open interest. Min: 0.

Example: 10000

>= 0

limit Seasonality Performers Limit optional

How many items to return. Default: 50. Min: 1.

Example: 10 Default: 50

>= 1

order Seasonality Performance Order By optional

Optional columns to order the result by

Example: ticker

enum: month, positive_closes, years, positive_months_perc, median_change, avg_change, max_change, min_change

order_direction OrderDirection optional

Whether to sort descending or ascending. Descending by default.

Example: asc Default: desc

enum: desc, asc

Responses

200 422 500

Response Body 200 OK

avg_change Seasonality Average Change

The average relative price change per day for the month.

Example: 0.09494354167379757

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.

Example: 2965813810400

max_change Seasonality Max Change

The maximum relative price change per day for the month.

Example: 0.14970489711277724

median_change Seasonality Median Change

The median relative price change per day for the month.

Example: 0.09494354167379757

min_change Seasonality Min Change

The minimum relative price change per day for the month.

Example: 0.0401821862348179

month Seasonality Month Number

The number indicating the month the data applies for. e.g. 1 -> January, 2 -> February, ...

Example: 5

positive_closes Seasonality Positive Closes Count

The number of years, the month had a positive close.

Example: 2

positive_months_perc Seasonality Positive Months Percent

The relative amount of times, the month had a positive close. Multiply with 100 to get the amount in percent.

Example: 0.6667

sector Market General Sector

The financial sector of the ticker. Empty if unknown or not applicable such as ETF/Index.

Example: Technology

ticker Stock Ticker

The stock ticker.

Example: AAPL

years Seasonality Year Count

The number of years used to calculate the data.

Example: 3

Try It GET

API Token

Path Parameters

month required

Query Parameters

min_years Min Years

ticker_for_sector SingleTickerForSector

s_p_500_nasdaq_only Nasdaq Only

min_oi Min Open Interest

limit Seasonality Performers Limit

order Seasonality Performance Order By

order_direction OrderDirection

Request Sample

curl -X GET "https://api.unusualwhales.com/api/seasonality/{month}/performers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import http.client

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

Response Example 200

{
  "data": [
    {
      "avg_change": "0.0592",
      "marketcap": "19427901578",
      "max_change": "0.1104",
      "median_change": "0.0639",
      "min_change": "0.0091",
      "month": 5,
      "positive_closes": 11,
      "positive_months_perc": "1.1",
      "sector": "Healthcare",
      "ticker": "ICLR",
      "years": 10
    },
    {
      "avg_change": "0.0577",
      "marketcap": "1927713687",
      "max_change": "0.2301",
      "median_change": "0.0417",
      "min_change": "-0.2485",
      "month": 5,
      "positive_closes": 10,
      "positive_months_perc": "1",
      "sector": "Technology",
      "ticker": "AMBA",
      "years": 10
    },
    {
      "avg_change": "0.0664",
      "marketcap": "60982620879",
      "max_change": "0.1791",
      "median_change": "0.07291",
      "min_change": "-0.0878",
      "month": 5,
      "positive_closes": 15,
      "positive_months_perc": "0.9375",
      "sector": "Healthcare",
      "ticker": "MCK",
      "years": 16
    },
    {
      "avg_change": "0.0674",
      "marketcap": "24233152429",
      "max_change": "0.2167",
      "median_change": "0.0723",
      "min_change": "-0.1812",
      "month": 5,
      "positive_closes": 15,
      "positive_months_perc": "0.9375",
      "sector": "Communication Services",
      "ticker": "TTWO",
      "years": 16
    }
  ]
}