Documentation
Watchlist & Market Data
The watchlist keeps a focused set of symbols available in Terminal and Dashboard. It combines quote snapshots with chart and detail actions; available fields vary by market, symbol, and upstream provider.
Watchlist actions
- Add or remove supported symbols within your account limit.
- Review latest price, change, percentage change, and compact history where available.
- Open a symbol detail view or replace/open a chart with that symbol.
- Use the selected symbol as context for alerts and manual trading.
- Inspect related fundamentals, technical gauges, forecasts, range performance, sector data, and branding when returned.
Data behavior
Quotes and chart history can come from different endpoints and update schedules. Fundamentals, analyst fields, gauges, logos, and sector information are not available for every symbol or asset class. A missing field is not automatically zero.
The streaming watchlist response can also return unsupported or missing symbols and an account-specific symbol limit. If an update fails, confirm the canonical symbol and wait for the market-data connection to become ready before retrying.
Chart and multi-chart context
Opening a watchlist symbol can replace the active chart or create chart context depending on the action. In multi-chart workspaces, select the intended chart first and confirm the resulting ticker before adding indicators, alerts, or orders.
Data limitations
Market data can be delayed, adjusted, incomplete, cached, or temporarily unavailable. Corporate actions and symbol mappings can change historical presentation. Do not use an isolated Astral quote as the sole confirmation for a live order; review the order preview and broker data.
Building a useful watchlist
A watchlist is most useful when every symbol has a reason to be there. Keep separate mental categories for active research, open exposure, event monitoring, and long-term comparison. Astral currently presents a focused symbol list rather than promising portfolio-grade tagging or screening, so remove stale symbols when the list stops being scannable.
For each symbol, decide what would cause you to act or remove it. That might be a price level, earnings date, technical condition, change in fundamentals, or a completed research question. Create an alert when the condition can be stated precisely; do not rely on repeatedly checking the quote row.
Interpreting quote fields
- Last price is the most recent value returned by the current quote source, not necessarily a broker-executable price.
- Change and percentage change depend on the comparison session or prior close used by the feed.
- Sparkline or range chart is a compact trend view and can use a different history request from the quote snapshot.
- Fundamental and analyst fields can have reporting dates older than the latest quote.
- Technical gauges summarize selected calculations; inspect the chart and interval before treating a label as a signal.
Symbol and asset-class differences
Equities, funds, futures, crypto, and prediction-market contracts can use different identifiers, trading calendars, quote conventions, and provider availability. A symbol accepted by search is not proof that every chart interval, dataset, alert type, broker, or strategy operation supports it.
If a ticker resolves to the wrong instrument, remove it and search using the complete name or canonical provider symbol. For a live trade, verify the instrument description in the broker preview as well as the ticker.
When values disagree
First compare timestamps, currency, account, session, and whether the value is adjusted. Then distinguish among a market-data quote, a chart bar, an Astral paper ledger, and broker-reported state. These sources answer different questions and do not update atomically.