For educational and research purposes only, not investment advice.
Trading Agents Lab
documentation

Read the source.

Everything you need to install, configure, and reason about Trading Agents Lab. The same documentation that ships inside the desktop app's Help menu, published here so anyone can learn from it, not just users.

Designed as a teaching artifact for Clawdemy and other AI-education programs. If you're here to understand agentic systems, start with How it works and Reading the debate.

ChatGPT OAuth

Use your paid ChatGPT subscription to power TradingAgentsLab debates, no API key, no per-token billing.

Clawless Connector

What the optional Clawless gateway tap is, how it fits into TradingAgentsLab, and when it activates.

Configuring LLM Providers

How to connect OpenAI, Anthropic, OpenRouter, Google Gemini, xAI Grok, and MiniMax; how to pick which provider and model each debate uses; how keys are stored.

Cost Guard

Stacked daily / weekly / monthly USD caps and an optional sessions-per-day rate cap. Optional. Off by default. Override per-run.

Crypto tickers

Analyze crypto pairs the same way you analyze equities. BTC, ETH, BTC/USD, BTC-USD all work; the engine routes to the right data source automatically.

Data Providers

Where market data comes from, what the engine fetches, and how to add Alpaca for power-user data access.

Frequently Asked Questions

Posture, license, what TradingAgentsLab is and is not, and the relationships with upstream and Clawless.

Getting Started

How to clone the repo, set up the engine, install the desktop, and run TradingAgentsLab for the first time.

How It Works

A conceptual walkthrough of the multi-agent debate pipeline, from ticker input to final decision.

Keyboard Shortcuts

Every keyboard shortcut in TradingAgentsLab, menu accelerators and page-level shortcuts.

Local LLM (Ollama / LM Studio)

Run debates entirely on your machine, no API key, no per-token bill, no data leaves your computer.

Reading the Debate

A guided tour of the Analyze page, every element explained, from the input form to the decision card.

Security and Storage

Where TradingAgentsLab stores data on disk, how secrets are protected, and what to do when you change machines.

Social sentiment (StockTwits + Reddit)

The sentiment_analyst agent grounds its analysis in real social data, bullish/bearish ratios from StockTwits and recent discussion from finance subreddits. No API key required.

Troubleshooting

Common problems and how to fix them.

Webhooks

Push every completed debate's decision to your own systems, Telegram, Slack, Discord, or any HTTPS endpoint.