# Watchlists Source: https://docs.settlemint.com/docs/console/personal/watchlists Follow assets in lists you name, read their prices and your holdings, trade from a row, and see your price alerts. Watchlists is where you keep the assets you follow. You name your own lists, add an asset from a search or with the **Watch** star on any asset page, and read each asset's last price, change and your holding beside the instruments it trades as. A row opens the trading workspace for its instrument. Under the lists, "Price alerts" shows the alerts you set on instruments. A watchlist is yours alone. Nobody else in the organisation sees it, and it belongs to the organisation you are signed in to, so another organisation shows its own lists. Following an asset places no order and changes nothing about the asset or your access to it. ![Watchlists page with no lists yet, a New list button and an empty Price alerts section](https://docs.settlemint.com/docs/screenshots/console-watchlists-page.light.en.webp) [Screenshot] The Watchlists page with no lists yet, a "New list" button and an empty "Price alerts" section. With no list yet, the page says "No watchlists yet" and "Create one, or select Watch on any asset.", with a **New list** button. Below it, "Price alerts" says "No price alerts yet". Once you add a list, "My lists" sits beside the assets of the selected list. ## Before you start [#before-you-start] - Your account must have finished onboarding. The asset search lists EVM assets only. On a deployment that has Canton switched on, it returns nothing while a Canton network is selected. - Prices come from the venue the asset trades on. An asset that no venue lists as an instrument still sits in your list, with **Not tradable on the venue yet** in place of a price. ## Steps [#steps] ### Open Watchlists [#open-watchlists] Select **Watchlists** under "Personal" in the sidebar. With no list yet, the page says "No watchlists yet" and "Create one, or select Watch on any asset." with a "New list" button. Otherwise "My lists" shows each list with its name, a "Default" badge on the default list and the number of assets it holds. On a narrow screen the lists run sideways above the selected list. ### Create a list [#create-a-list] 1. Select **New list** to open "New watchlist". 2. Enter a name in **Watchlist name**, up to 80 characters. 3. Select **Create**. The dialog says the list "Saves to your account at once, with no PIN", so no wallet verification is asked. The new list opens. ### Add an asset [#add-an-asset] Type in **Search by name or symbol** above the list. The results show up to 8 assets, each with its symbol, name and type. Select "Add" beside the asset. An asset already in the list shows "In this list" instead. With no match the search says "No asset matches" followed by your text in quotation marks. "Escape" clears the search. A notification confirms the addition, as "`{symbol}` added to `{list}`" with the asset's symbol and the list's name, and carries an **Undo** action that removes the asset again for 8 seconds. ### Read the table [#read-the-table] Each row is one asset. The columns are **Asset**, "Instruments", "Last", "Change", "Previous close", "Open", "Value", "Bid / Ask", "You hold" and "Status", and a column of row actions. The toolbar offers the column picker only, with no search, filter or export. On a narrow screen the table folds some columns away, and the picker shows or hides each one. - **Asset** shows the symbol, a badge for the asset type and the name. Rows sit in groups by asset type. - **Instruments** lists the instruments the asset trades as. Each is a link to its trading workspace. A pin marks the instrument you pinned. An instrument the Console cannot load shows as dashed text that is not a link. - **Last**, "Change", "Previous close", "Open", "Value" and "Bid / Ask" describe the asset's first instrument, the pinned one when you pinned one. A figure the venue has not produced yet shows a dash. "Change" is red when it is negative. - **You hold** shows your balance of the asset, or a dash when you hold none. - **Status** shows the instrument's phase as a badge, such as "Open for trading", "Instrument halted" or "Delisted". ### Trade, look closer or remove an asset [#trade-look-closer-or-remove-an-asset] - **Trade** opens the trading workspace for the asset's first instrument. It is disabled, with "Not tradable on the venue yet", when the asset has no instrument. [Trading](https://docs.settlemint.com/docs/console/my-assets/trading) covers placing an order. - The eye icon, **Quick view**, opens a panel with the asset's "Name", "Symbol", "Type" and "Address", and under "Instruments for" its symbol each instrument with its phase and a "Pin" or "Unpin" button. "Pin" makes that instrument the one the row's prices and "Trade" use. "Trade" opens the workspace, and "Research" opens the asset's instrument page. An asset with no instrument shows "This asset is not listed as an instrument on any venue". - The **Actions** menu of a row offers "Move up", "Move down" and "Remove". "Remove" takes the asset off this list only, with a notification and an "Undo" action that puts it back for 8 seconds. ## Order your lists and assets [#order-your-lists-and-assets] Each list has an **Actions** menu, named for the list, with "Rename", "Make default", "Move up", "Move down" and "Delete list". The default list has no "Make default", and the first and last lists have no "Move up" and no "Move down" respectively. - **Rename** opens "Rename watchlist" with the current name. Change it, up to 80 characters, and select "Save". "Cancel" closes it. - **Make default** makes the list the one "Watch" adds to. One list is the default at a time. With no list marked, the oldest list counts as the default. - **Delete list** removes the list and its entries from your account, with a "Watchlist deleted" notification and an "Undo" action for 8 seconds. "Undo" restores the list and says "Watchlist restored". Deleting needs no wallet verification. - **Move up** and "Move down" on a row swap the asset with its neighbour in its group. They are disabled, with "Clear the sort to reorder", while a column sort is on. ## Follow an asset from anywhere [#follow-an-asset-from-anywhere] The **Watch** button with a star appears on an asset's page, on an instrument's page, in the trading workspace and in the holding briefing on your Dashboard. Select it to add the asset to your default list, or to take it out of that list when it is already there. With no list at all, it creates one called "Watchlist" and adds the asset. Once an asset is in a list the button reads "Watching · " followed by the list name, or "Watching · 3 lists" for three. The arrow beside it opens **Save** followed by the asset's symbol and "to", with a checkbox for each of your lists, so you add or remove the asset per list. "New list" creates a list from there, and "Manage watchlists" opens this page. ## Price alerts [#price-alerts] Below the lists, **Price alerts** shows the alerts you set on instruments, each with its instrument, condition, status and creation date. [Trading](https://docs.settlemint.com/docs/console/my-assets/trading#set-a-price-alert) explains how to set, read and delete one. Other users never see yours. ## You should see [#you-should-see] - Open **Watchlists** and select the list. The asset shows as a row, and the count beside the list's name includes it. The "Watch" button on the asset's own page reads "Watching · " followed by the list name. ## Troubleshooting [#troubleshooting] **The page says your watchlists could not be loaded** The page shows "Your watchlists could not be loaded." when the read of your lists fails, and the same message in the table when the read of one list's assets fails. Select **Try again**. **An asset does not appear in the search** The search matches the name and the symbol of EVM assets only. Check the spelling, or search for part of the name. On a deployment that has Canton switched on, the search returns nothing while a Canton network is selected. **Every price shows a dash** The asset has no instrument on a venue you can read, or the venue has not produced that figure yet. **Last**, "Change", "Previous close", "Open", "Value" and "Bid / Ask" fill in when the instrument trades. An asset with no instrument shows "Not tradable on the venue yet" and a disabled "Trade". **Move up and Move down are disabled** A column sort is on. The rows follow the sort until you clear it, so the menu says "Clear the sort to reorder". **A deleted list or removed asset did not come back** **Undo** is on the notification for 8 seconds, and the Console has no other restore action. Create the list again, or add the asset from the search. ## Frequently asked questions [#frequently-asked-questions] **Can a colleague see my watchlist?** No. A watchlist belongs to one user in one organisation, and the Console has no way to share it. **Does following an asset notify me when it moves?** No. A watchlist only shows prices. A price alert notifies you when an instrument trades at or beyond a price, and you set one from the trading workspace. ## API routes [#api-routes] The same lists are available through the [Platform API](https://docs.settlemint.com/docs/api-reference/v2) under `/api/v2/addons/trading-venues/watchlists`, which lists, creates, renames, reorders and deletes your lists, adds and removes assets, and reorders the assets in a list. Your session is enough, and no request asks for wallet verification. [CLI commands](https://docs.settlemint.com/docs/api-reference/cli/commands) covers the command-line equivalent.