Skip to content

Watchlist:Watchlists

Controller: Watchlist
Topic: Watchlists
Action: Sub
Permissions: None

An ordered array of zero or more Watchlist Change objects, to be applied in sequence.

NameTypeExpectDescription
OperationStringAlwaysThe operation being performed. One of:
Add: Adding a new Watchlist.
Update: Updating an existing Watchlist.
Remove: Removing a Watchlist.
Clear: Clearing all Watchlists.
WatchlistObjectOptionalA Watchlist object. Will be omitted when clearing. Will always be provided in all other situations.
NameTypeExpectDescription
IDStringAlwaysA unique identifier of this Watchlist.
NameStringOptionalA display name for this Watchlist. Omitted on Remove.
DescriptionStringOptionalA brief description for this Watchlist, if any. Omitted on Remove.
CategoryStringOptionalThe category this Watchlist belongs to, if any. Omitted on Remove.
IsWritableBooleanYesTrue if the Watchlist can be edited, False for Read Only.

Send:

{"Controller":"Watchlist","Topic":"Watchlists","Action":"Sub","Confirm":true}

Receive:

{
"Controller":"Watchlist",
"Topic":"Watchlists",
"Data":
[
{"Operation":"Clear"},
{"Operation":"Add","Watchlist":{"ID":"10A4","Name":"ASX-200","Description":"XJO ASX-200 index members","IsWritable":false}},
...
{"Operation":"Add","Watchlist":{"ID":"2F4A","Name":"Custom User Watchlist","IsWritable":true}}
]
}
{"Controller":"Watchlist","Topic":"Watchlists","Action":"Sub","Confirm":true}