Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Send your Edgeful API key in the Authorization header as Bearer <api-key> (for example, Bearer ef_live_<random>).

Body

application/json
market
enum<string>
required

the market whose watchlist changes.

Available options:
futures,
stock,
forex,
crypto
add
string[] | null

tickers to append in order, uppercased and validated on the market; duplicates change nothing.

Maximum array length: 100
Required string length: 1 - 30
remove
string[] | null

tickers to drop; a missing ticker changes nothing.

Maximum array length: 100
Required string length: 1 - 30

Response

Successful Response

status
string
required

updated or unchanged.

market
string
required

the market.

previous
string[]
required

the list before this write, for undo.

current
string[]
required

the list after this write.

changed
WatchlistChanged · object
required

what this write changed.