Skip to main content
POST
Create option watchlist

Authorizations

Authorization
string
header
required

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

Body

application/json

Option watchlist

The name, option symbols and color of an option watchlist. Each new option symbol must have option data for the last trading day and must not be expired.

chains
string[]
required

The option symbols on the watchlist.

Example:
name
string
required

The watchlist name. Names are unique per user and watchlist type.

Example:

"Semiconductors"

color
enum<string> | null

The watchlist color shown on unusualwhales.com.

Available options:
green,
red,
yellow,
blue,
purple,
pink,
orange,
gray
Example:

"blue"

Response

The created option watchlist

The created or updated option watchlist.

data
Option watchlist · object

An option watchlist of the user.