Watchlists and token data

Watchlists organize tokens you want to follow. Use the network and address to distinguish assets with similar names or tickers.

Ask the assistant to read your saved watchlist. It returns the signed-in account's saved identities, preserving exact contract addresses. An empty list and an unavailable watchlist service are distinct outcomes; the active chart is not a substitute for saved entries.

Mobile Watchlist drawer

Open Menu → Watchlist for saved assets only. The drawer uses the Positions layout, with Add watchlist asset (+) in the top-right toolbar and Search watchlist below it. Adding opens the existing asset picker above the drawer. There is no Edit button. To remove an asset, open its chart and use the chart's watchlist action. Removing an item does not trade or close its position.

Mobile ticker logos have no star overlays, and the Token info section is removed. There are no Tokens/Perps or category tabs in this drawer. Tap an asset for its chart above the current route; closing the chart returns to Watchlist. Desktop retains its full token panel, including stars and Token info. The mobile Search route still offers its separate Watchlist/Tokens/Perps browser.

Open lists and discover assets

1. In Terminal, open the tokens/watchlist icon on the left rail.
2. Choose Watchlist for saved/recent assets, Tokens for spot discovery, or Perps for Hyperliquid markets.
3. Tokens opens on Crypto by default. Choose Trending, Top, Growing holders, Broader ownership, or Fresh traction where offered to change lists. Scroll the filter row to reveal additional lists. There is no Bonding tab in the Terminal token panel.
4. Use Filter by chain to narrow the list, then click an asset to open its chart. On Trending and Top, a chain shows that network's own list (up to 100 and 30 tokens), not just its tokens from the all-chains list. Trending's filter offers only the networks where its ranking is measured (when it ranks by fees paid, the networks whose trading-app fees Astral reads); on another network it shows Trending isn't measured on … yet with Show Top on ….
5. Use Load more when additional results are available. An empty filtered list means no matches were returned for that view, not that the asset can never exist.

The Watchlist view offers the lists available to your account. Use the asset's available save/watchlist control to add it, select the desired list, and use its removal control to remove it. Research list ranking, saved ordering and recent viewing history are different sources; read the selector description before interpreting the order.

Available desktop token-star controls, the mobile Add action and an asset chart's watchlist action save to your signed-in account, so the assistant can read the same list. Older browser-only stars are copied into that account when the watchlist connects; the browser copy is cleared only after the service acknowledges the save. The combined list supports up to 50 assets. If Watchlist unavailable appears, use Retry after connectivity returns; if the combined list exceeds 50, remove saved assets and retry. A failed save does not confirm that the account list changed.

Recognize availability labels

Trading not available on this network yet can appear on a research asset. Its chart can still be useful, but the label is not removed by funding another network or upgrading a plan. Perps charts use venue trades and their own market identity, separate from spot indices. Token names can collide; use the full address and network when asking the agent to locate one.

Data context

Read Crypto index details

On desktop, in Tokens → Crypto, selecting ABTUSD, BTCUSD or another supported currency pair opens research/index details in Token info below the list, not a token-pool activity feed. Use Expand token info if minimized. Mobile Watchlist omits that section; open the asset chart for its research details. The panel omits the extra price-index explanation and routine loading/update text. Pool buy/sell counts, directional volume and unique traders remain unavailable for that identity, not zero; recovery messages and Retry market details remain available when details fail or are empty.

Live quotes are independent of the optional market-details request. Retry market details retries a failed, timed-out or empty details read for the same selected pair; it does not unlock pool data. Select an exact network/address-qualified token to inspect its supported activity and scope. See Crypto indexes and token activity for loading, the approximate ten-second optional-read deadline, missing data and desktop/mobile/Paper/Real boundaries.

For a Solana token, desktop Token info also shows Who holds it, a ring chart of how concentrated its ownership is, below the trading activity. On mobile it is in the token chart's About tab. See Who holds it.

Quotes, charts, token activity, holders and account state may come from different endpoints and update schedules. Compare the timestamp, source, denomination and selected token before interpreting a difference.

Missing liquidity, volume or holder data is not zero. A last price is not a guaranteed execution quote. Market cap, liquidity and volume measure different things.

Coverage

A token appearing in search does not establish support for every interval, indicator, backtest, alert or execution mode. Check Markets and the available actions in the workspace.

Limited history responses may contain only the latest page. has_more means earlier candles may be omitted; a page_omitted gap does not certify that no trades occurred. Read earlier pages before inferring the first trade in the requested window.

Monitoring

Use supported price or strategy conditions for alerts. Confirm the notification channel and account availability. Research metrics are not automatically eligible alert or strategy inputs.

Removing a watchlist item changes your list; it does not close a position or stop an associated strategy.