TradingAgents
Analyst, bull, bear, risk and portfolio-manager agents argue over one ticker.
by Tauric Research
Last updated
What it is
TradingAgents runs a LangGraph pipeline of language-model agents over one ticker and one date. Four analysts — market, sentiment, news, fundamentals — write reports; a bull and a bear researcher argue over them; a research manager picks a side; a trader converts the plan into a Buy, Hold or Sell with an entry price, a stop and sizing guidance; three risk debaters argue again; and a portfolio manager closes on a five-tier rating of Buy, Overweight, Hold, Underweight or Sell with an optional price target. Debate and risk rounds are configurable — one each by default, five each on the CLI's "Deep" preset — and every leg is its own model call.
Apache-2.0 by the LICENSE file, roughly 105,000 stars, not archived. Last release v0.4.0 on
31 August 2026; last commit to main 7 September 2026, merging an untagged v0.4.2 branch, with
pull requests still being closed on 13 September 2026. 179 issues and 204 pull
requests are open.
Pricing
Nothing to buy. Tauric Research publishes no price page at all — /pricing and /plans both
404 on 13 September 2026 — and offers "enterprise access" only through a contact form. The bill
is your own model key: gpt-5.6 and gpt-5.6-luna by default, or Anthropic, Google, xAI,
DeepSeek, Qwen, GLM, MiniMax, Groq, Mistral, NVIDIA, OpenRouter, Bedrock, Azure, Ollama and any
OpenAI-compatible endpoint.
Data & coverage
It ships no data of its own. Prices, indicators, fundamentals and news default to yfinance and
need no key; Alpha Vantage is the alternative and does; FRED macro needs a free key;
Polymarket, StockTwits and Reddit's public RSS need none. Any market Yahoo covers works through
the exchange suffix — 0700.HK, 7203.T, AZN.L, RELIANCE.NS, 600519.SS — with the alpha
benchmark chosen per market. Forex and commodity symbols normalise to Yahoo's forms, but the
fundamentals leg is equity-shaped and has little to read outside stocks.
Limitations
- The output is a recommendation. The schema carries a Buy/Overweight/Hold/Underweight/Sell rating, an entry price, a stop-loss, sizing such as "5% of portfolio", and a price target. Nobody stands behind any of it; the project's own disclaimer says it is not investment advice.
- No execution. The README's "sent to the simulated exchange and executed" has no code behind it — no broker, no fills, no position accounting anywhere in the repo.
- Not reproducible, by the project's own account: two runs of the same ticker and date can differ, and the curated reasoning models largely ignore the temperature knob.
- Not a backtester either. A historical date is point-in-time guarded — v0.4.0 fixed look-ahead in FRED vintages, social sentiment and the decision memory — but there is no portfolio simulator and no P&L, and the README says backtest results are not guaranteed to match any published figure, the paper's headline return included.
backtraderis a declared dependency and is imported nowhere in the package.pip install tradingagentsinstalls somebody else's package. The PyPI name is held by an unrelated third party at version 0.7.0 under MIT, advertised with the same summary line. The install is a clone pluspip install ., or the Docker image.- No MCP server, despite the category, and no API to call — a CLI and a Python import.
Alternatives
FinRobot covers similar ground and renders a formal analyst report instead of a debate transcript; FinGPT is the model layer rather than the harness. For market data wired into an LLM without an opinion attached, the servers in the MCP and AI agents category do that job and stop there.
Specs
- Interfaces
- Python, Python
- Export
- JSON
- Asset classes
- Stocks, ETF, Crypto, Forex, Indices, Commodities
- Markets
- US, CA, UK, Asia, AU, Global
- Platforms
- CLI, Library
- AI features
- Recommendations
- Capabilities
- News
- Pricing verified
- Capabilities verified
- Coverage verified
Also worth comparing
- MaverickMCP — Thirty-seven stock-analysis tools for any MCP client, on Yahoo data and no key.
- Vibe-Trading — A local finance research agent with 74 MCP tools, nine backtest engines and 14 brokers.
- AI Hedge Fund — LLM investor personas score a ticker, deterministic code sizes the book, nothing trades.
- Equibles — Scrapes SEC, FINRA, FRED and CFTC data into your own Postgres and serves it over MCP.
- Financial Datasets — US fundamentals and filings for agents, over REST and a first-party hosted MCP server.
- FinGPT — Financial LLM adapters, instruction datasets and training notebooks, all MIT.
FAQ
What does a single ticker cost to run?
The code is free; the language-model calls are not, and they are billed to your own key. The defaults are gpt-5.6 for the deep-reasoning agents and gpt-5.6-luna for the quick ones. Neither the repo nor tauric.ai publishes a token count or a dollar figure per run, so the only honest estimate is structural — at the default depth a run is four analyst legs with tool loops, two debate turns, three risk turns and three manager/trader calls, each carrying the accumulated reports forward. The CLI's "Deep" preset sets five rounds, which is ten debate turns and fifteen risk turns instead of two and three.
Does TradingAgents place trades?
No. The README says an approved proposal "will be sent to the simulated exchange and executed", but there is no exchange, broker or order code in the repository. What a run produces is a tree of Markdown reports and one JSON state log per ticker and date.
Will two runs of the same ticker on the same date agree?
Not reliably, and the project says so itself. Its Reproducibility section notes that provider sampling is non-deterministic, that the default reasoning models largely ignore the temperature setting, and that news and social sources keep moving even when the analysis date is pinned. Company identity and the price and indicator figures are the parts now resolved deterministically.
Is pip install tradingagents the right way to install it?
No, and the trap is well set. The tradingagents name on PyPI belongs to a third party — version 0.7.0, MIT, homepage mai0313.github.io — and it carries the same one-line summary as Tauric's repo, so the page reads as authentic. It is not Tauric Research's 0.4.0 Apache-2.0 project. The documented install is to clone the repo and pip install ., or to run the Docker image.