Docs & Beginner Guide
A plain-language guide to every page, signal, report, and score in TradingAgents AI.
New to stock research? Start here.
You do not need to begin with a ticker. Radar identifies what changed, the Market Screener helps you search by style, and New Analysis builds a detailed evidence trail for one company. A good first session is: scan one opportunity, read its evidence, add it to your watchlist, and investigate it only if the question matters to you.
Page guide
What each page is for
Overview
/appYour starting point for research, portfolio review, saved companies, and current market headlines.
What you will see
Remaining free runs, portfolio value and research coverage, watchlist entries, workflow shortcuts, recent reports, and market headlines.
How to use it
- Start here to see which part of the workspace needs attention.
- Open Portfolio X-Ray when research coverage or concentration needs review.
- Use the watchlist and market headlines to choose the next company to investigate.
- Reopen a recent report or start New Analysis when you already have a ticker in mind.
New Analysis
/app/newLaunch a multi-agent research workflow for one company and one analysis date.
What you will see
Broad ticker and company search across the Sharadar U.S. security directory, analysis date, research depth, analyst selection, model/provider choice, and cost-aware run controls.
How to use it
- Search by ticker or company name, such as AAPL or Apple; if company search is unavailable, press Enter to use a typed ticker directly.
- Keep the default analysts unless you have a specific reason to narrow the research.
- Use the site-funded model for a simple start, or connect your own provider key in Settings.
- Queue the run and follow its progress before opening the completed report.
Opportunity Radar
/app/radarFind companies with a recent filing, fundamental, corporate-action, or market-activity change worth investigating.
What you will see
Evidence-backed opportunity cards, an attention score, freshness, sectors, source categories, an alert queue, and a separate Market Screener.
How to use it
- Start with Top Opportunities or the 12-item Alert Queue.
- Read What Changed and Why It Matters before looking at the ticker.
- Open Evidence & Provenance to inspect the dates and source signals.
- Investigate a company you do not understand; Watch a company you want to follow.
- Use filters to narrow the feed by category, sector, freshness, or watchlist.
Market Screener
/app/radarRank a broad U.S. stock universe when you want to search by a consistent financial or market style.
What you will see
Balanced, Momentum, Value, and Lower Risk screens plus price, YTD return, valuation ratios, market cap, and a percentile score.
How to use it
- Choose the investment question you are trying to answer.
- Set a minimum market cap to remove names that are too small for your needs.
- Compare the metrics behind each result instead of relying on the score alone.
- Send interesting names to New Analysis for deeper evidence and debate.
Strategy Lab
/app/labTest transparent, rules-based stock strategies against historical data instead of relying only on a current opinion.
What you will see
Adjusted historical performance, SPY comparison, CAGR, volatility, Sharpe and Sortino ratios, maximum drawdown, market exposure, trades, and stated assumptions.
How to use it
- Enter a ticker or open Strategy Lab from a completed research report.
- Choose trend following, six-month momentum, or buy and hold.
- Select a date range and realistic transaction cost.
- Compare the strategy with SPY and read the assumptions before drawing conclusions.
- Use the result to challenge the research thesis, not as a prediction of future returns.
Market News
/newsBrowse the persistent public archive of finance, business, and economic headlines and see which companies are explicitly connected.
What you will see
A paginated public archive with publisher, publication time, topics, event significance, related tickers, and original-source links.
How to use it
- Browse the public archive before creating an account, then filter to ticker-linked stories when signed in.
- Use Watchlist Only to see stories connected to companies you already follow.
- Open the brief, verify the material facts, and check the original source.
- Choose Analyze on a related ticker when the story creates a research question.
Portfolio X-Ray
/app/portfolioSee how your saved stock positions combine into market value, unrealized profit and loss, sector exposure, concentration, and historical risk.
What you will see
A manual holdings editor, current quote values, position weights, known cost basis, unrealized P/L, sector allocation, a research review queue, a hypothetical scenario simulator, a portfolio-versus-SPY growth curve, concentration, historical risk contribution, volatility, drawdown, beta, VaR, and return correlations.
How to use it
- Search by ticker or company, then enter the number of shares you own and your average cost when available.
- Import a CSV with Ticker, Shares, and optional Average Cost columns, or export the saved portfolio with current values and research status.
- Save the portfolio to calculate current market values and position weights.
- Review whether one stock or sector drives too much of the portfolio result.
- Use the research review queue to prioritize holdings that have never been analyzed, whose last report is older than 90 days, or that have material headlines after the report.
- Run a 6-month, 1-year, or 2-year historical scan to compare capital weight with risk contribution, then check volatility, drawdown, beta, and positions that move together.
- Use the scenario simulator to apply hypothetical all-holding, sector, or ticker shocks and inspect the projected dollar impact.
- Use Analyze on a large position when its research thesis needs another look.
- Treat X-Ray as a diagnostic: it is not broker-connected and does not include cash, dividends, taxes, or trading advice.
Analysis History
/app/historyFind, reopen, and compare previous research runs.
What you will see
Ticker, analysis date, final decision, model mode, status, and report actions.
How to use it
- Search by ticker when reviewing a company over time.
- Open a report to inspect the evidence, full agent discussion, and immutable source manifest.
- Select two to four completed reports for the same ticker to compare their signals, models, source domains, and report revisions.
- Use the revision history on a report to compare earlier analyses of the same ticker.
- Remember that an older report reflects the information available on its analysis date.
Watchlist
/app/watchlistKeep important companies one click away, synchronized to your account, and monitor basic live quotes.
What you will see
Saved tickers, current price, daily change, quote source, and a Quick Analyze action.
How to use it
- Add companies from Radar, the search field, or the Watchlist page; they sync when you sign in on another device.
- Use Watchlist Only in Radar to focus on developments affecting followed companies.
- Quick Analyze a watched company when you want a fresh research report.
Settings
/app/settingsManage your account and optional provider API keys.
What you will see
Account information and encrypted BYOK provider-key controls.
How to use it
- Add a provider key only if you need more runs, another model, or provider-specific access.
- Keys are encrypted at rest and injected only into that run's isolated process.
- Remove a saved key when it is no longer needed.
Reading a research report
A report is a structured argument, not a single answer. Read the final signal last. First inspect the evidence, data dates, disagreements, and the conditions that would change the conclusion.
Evidence
Analyst sections cover fundamentals, technicals, news, and sentiment. Check the analysis date and source data.
Bull vs. bear
Researchers argue the strongest opposing cases. Read both before judging conviction.
Risk review
Aggressive, conservative, and neutral reviewers test position sizing, uncertainty, and invalidation levels.
Final synthesis
The portfolio manager produces the decision, thesis, key risks, and a Buy/Hold/Sell stance for that date.
Beginner glossary
Terms you will see
A sensible first workflow
- 01
Scan Radar for a change you understand.
- 02
Read the evidence and the company context.
- 03
Watch it or run a deeper analysis.
- 04
Record what would prove the thesis wrong.