Watchlist

Create and manage watchlists.

Get Watchlists

WatchlistGetWatchlistsResponse v1().watchlist().getWatchlists(, )

GET/v1/watchlists

Get Watchlist By ID

WatchlistGetWatchlistByIdResponse v1().watchlist().getWatchlistById(, )

GET/v1/watchlists/{watchlist_id}

Create Watchlist

WatchlistCreateWatchlistResponse v1().watchlist().createWatchlist(, )

POST/v1/watchlists

Delete Watchlist

JsonValue v1().watchlist().deleteWatchlist(, )

DELETE/v1/watchlists/{watchlist_id}

Add Watchlist Item

WatchlistAddWatchlistItemResponse v1().watchlist().addWatchlistItem(, )

POST/v1/watchlists/{watchlist_id}/items

Delete Watchlist Item

JsonValue v1().watchlist().deleteWatchlistItem(, )

DELETE/v1/watchlists/{watchlist_id}/items/{item_id}

ModelsExpand Collapse

class AddWatchlistItemData:

Response data for adding a watchlist item

String itemId

ID of the created item

formatuuid

class WatchlistDetail:

Detailed watchlist with all items

String id

Watchlist ID

formatuuid

LocalDateTime createdAt

Creation timestamp

formatdate-time

List<WatchlistItemEntry> items

Items in the watchlist

String id

Item ID

formatuuid

LocalDateTime addedAt

When the item was added

formatdate-time

Optional<String> addedPrice

Price when the item was added

Optional<Instrument> instrument

Instrument details

String id

Unique OEMS instrument identifier (UUID)

formatuuid

String countryOfIssue

The ISO country code of the instrument’s issue

String currency

The ISO currency code in which the instrument is traded

boolean easyToBorrow

Indicates if the instrument is classified as Easy-To-Borrow

boolean isLiquidationOnly

Indicates if the instrument is liquidation only and cannot be bought

boolean isMarginable

Indicates if the instrument is marginable

boolean isRestricted

Indicates if the instrument is restricted from trading

boolean isShortProhibited

Indicates if short selling is prohibited for the instrument

boolean isThresholdSecurity

Indicates if the instrument is on the Regulation SHO Threshold Security List

boolean isTradable

Indicates if the instrument is tradable

String symbol

The trading symbol for the instrument

String venue

The MIC code of the primary listing venue

Optional<String> adv

Average daily share volume from the security definition.

Optional<LocalDate> expiry

The expiration date for options instruments

formatdate

Optional<SecurityType> instrumentType

The type of security (e.g., Common Stock, ETF)

One of the following:

COMMON_STOCK("COMMON_STOCK")

PREFERRED_STOCK("PREFERRED_STOCK")

OPTION("OPTION")

CASH("CASH")

OTHER("OTHER")

Optional<String> longMarginRate

The percent of a long position’s value you must post as margin

Optional<String> name

The full name of the instrument or its issuer

Optional<String> notionalAdv

Notional ADV (adv × previous_close). The primary liquidity signal used by /instruments/search ranking. Computed at response time so it stays consistent with whatever adv and previous_close show.

Optional<List<LocalDate>> optionsExpiryDates

Available options expiration dates for this instrument. Present only when include_options_expiry_dates=true in the request.

Optional<String> previousClose

Last close price from the security definition.

Optional<String> shortMarginRate

The percent of a short position’s value you must post as margin

Optional<String> strikePrice

The strike price for options instruments

String name

Watchlist name

class WatchlistEntry:

Represents a user watchlist.

String id

The unique identifier for the watchlist.

formatuuid

LocalDateTime createdAt

The timestamp when the watchlist was created.

formatdate-time

String name

The user-provided watchlist name.

class WatchlistItemEntry:

A single item in a watchlist

String id

Item ID

formatuuid

LocalDateTime addedAt

When the item was added

formatdate-time

Optional<String> addedPrice

Price when the item was added

Optional<Instrument> instrument

Instrument details

String id

Unique OEMS instrument identifier (UUID)

formatuuid

String countryOfIssue

The ISO country code of the instrument’s issue

String currency

The ISO currency code in which the instrument is traded

boolean easyToBorrow

Indicates if the instrument is classified as Easy-To-Borrow

boolean isLiquidationOnly

Indicates if the instrument is liquidation only and cannot be bought

boolean isMarginable

Indicates if the instrument is marginable

boolean isRestricted

Indicates if the instrument is restricted from trading

boolean isShortProhibited

Indicates if short selling is prohibited for the instrument

boolean isThresholdSecurity

Indicates if the instrument is on the Regulation SHO Threshold Security List

boolean isTradable

Indicates if the instrument is tradable

String symbol

The trading symbol for the instrument

String venue

The MIC code of the primary listing venue

Optional<String> adv

Average daily share volume from the security definition.

Optional<LocalDate> expiry

The expiration date for options instruments

formatdate

Optional<SecurityType> instrumentType

The type of security (e.g., Common Stock, ETF)

One of the following:

COMMON_STOCK("COMMON_STOCK")

PREFERRED_STOCK("PREFERRED_STOCK")

OPTION("OPTION")

CASH("CASH")

OTHER("OTHER")

Optional<String> longMarginRate

The percent of a long position’s value you must post as margin

Optional<String> name

The full name of the instrument or its issuer

Optional<String> notionalAdv

Optional<List<LocalDate>> optionsExpiryDates

Available options expiration dates for this instrument. Present only when include_options_expiry_dates=true in the request.

Optional<String> previousClose

Last close price from the security definition.

Optional<String> shortMarginRate

The percent of a short position’s value you must post as margin

Optional<String> strikePrice

The strike price for options instruments