Watchlist:Watchlists

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

Payload

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

Watchlist Change object

Name Type Expect Description
Operation String Always The operation being performed. One of:
Add: Adding a new Watchlist.
Update: Updating an existing Watchlist.
Remove: Removing a Watchlist.
Clear: Clearing all Watchlists.
Watchlist Object Optional A Watchlist object. Will be omitted when clearing. Will always be provided in all other situations.

Watchlist object

Name Type Expect Description
ID String Always A unique identifier of this Watchlist.
Name String Optional A display name for this Watchlist. Omitted on Remove.
Description String Optional A brief description for this Watchlist, if any. Omitted on Remove.
Category String Optional The category this Watchlist belongs to, if any. Omitted on Remove.
IsWritable Boolean Yes True if the Watchlist can be edited, False for Read Only.

Example

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}