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

01

Overview

/app

Your starting point for research, portfolio review, saved companies, and current market headlines.

Open

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.
02

New Analysis

/app/new

Launch a multi-agent research workflow for one company and one analysis date.

Open

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.
03

Opportunity Radar

/app/radar

Find companies with a recent filing, fundamental, corporate-action, or market-activity change worth investigating.

Open

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.
04

Market Screener

/app/radar

Rank a broad U.S. stock universe when you want to search by a consistent financial or market style.

Open

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.
05

Strategy Lab

/app/lab

Test transparent, rules-based stock strategies against historical data instead of relying only on a current opinion.

Open

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.
06

Market News

/news

Browse the persistent public archive of finance, business, and economic headlines and see which companies are explicitly connected.

Open

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.
07

Portfolio X-Ray

/app/portfolio

See how your saved stock positions combine into market value, unrealized profit and loss, sector exposure, concentration, and historical risk.

Open

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.
08

Shared Research Archive

/app/archive

Read completed stock reports contributed by other users without exposing contributor identities.

Open

What you will see

Shared reports with ticker, analysis date, decision, model, publication time, evidence summary, search filters, and full report access.

How to use it

  • Search by ticker or words from the report excerpt.
  • Filter by BUY, HOLD, or SELL and open a report to read the complete research.
  • Treat a shared report as a research starting point and check its analysis date and sources.
  • Repeated analyses for the same ticker are not shared again inside a rolling six-hour window.
09

Analysis History

/app/history

Find, reopen, and compare previous research runs.

Open

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.
10

Watchlist

/app/watchlist

Keep important companies one click away, synchronized to your account, and monitor basic live quotes.

Open

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.
11

Settings

/app/settings

Manage your account and optional provider API keys.

Open

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.

Important: BUY, HOLD, and SELL are research conclusions for the specified date. They are not personalized advice, price guarantees, or instructions for your account.

Beginner glossary

Terms you will see

A sensible first workflow

  1. 01

    Scan Radar for a change you understand.

  2. 02

    Read the evidence and the company context.

  3. 03

    Watch it or run a deeper analysis.

  4. 04

    Record what would prove the thesis wrong.