TradingAgents/docs/configuration.md

Configuration Reference — DEXAgents

All configuration is via environment variables in .env or shell exports.

---

LLM Providers

Variable	Required	Description
OPENAI_API_KEY	One required	OpenAI GPT models
GOOGLE_API_KEY	One required	Google Gemini models
ANTHROPIC_API_KEY	One required	Anthropic Claude models
XAI_API_KEY	One required	xAI Grok models
OPENROUTER_API_KEY	One required	OpenRouter (multi-model)

Configure the active provider in default_config.py or at runtime:

config["llm_provider"] = "openai"  # openai, google, anthropic, xai, openrouter, ollama
config["deep_think_llm"] = "gpt-4o"
config["quick_think_llm"] = "gpt-4o-mini"

---

DEX Data Providers (Scenario 1)

Variable	Required	Description
COINGECKO_API_KEY	No	CoinGecko Pro key (free tier available)
BIRDEYE_API_KEY	Yes	Birdeye Solana analytics

DeFiLlama requires no API key.

---

On-Chain Execution (Scenario 2)

Solana

Variable	Required	Description
SOLANA_RPC_URL	Yes	RPC endpoint (default: mainnet-beta)
SOLANA_PRIVATE_KEY	Yes	Wallet private key (base58) — never commit!

Recommended RPC: Helius, Alchemy, or QuickNode for production.

EVM (Ethereum / Base / Arbitrum)

Variable	Required	Description
ETH_RPC_URL	Yes	EVM RPC endpoint
ETH_PRIVATE_KEY	Yes	Wallet private key (hex) — never commit!
ONEINCH_API_KEY	Yes	1inch API key (free at dev.1inch.io)

---

Google Custom Search (Web Research Analyst)

Variable	Required	Default	Description
GOOGLE_SEARCH_API_KEY	Yes	—	Google Cloud API key
GOOGLE_SEARCH_ENGINE_ID	Yes	—	Custom Search Engine ID (cx)
GOOGLE_SEARCH_DAILY_LIMIT	No	95	Hard cap on queries/day

Free tier: 100 queries/day. The default limit of 95 leaves a 5-query safety margin. To increase: enable billing in Google Cloud Console and raise GOOGLE_SEARCH_DAILY_LIMIT.

---

Infrastructure (Scenario 3)

Variable	Required	Description
DATABASE_URL	Yes	PostgreSQL connection string
REDIS_URL	No	Redis URL (default: redis://localhost:6379)
TELEGRAM_BOT_TOKEN	No	Telegram bot for alerts
TELEGRAM_CHAT_ID	No	Target chat for alerts

---

Runtime Configuration (default_config.py)

DEFAULT_CONFIG = {
    # LLM
    "llm_provider": "openai",
    "deep_think_llm": "gpt-4o",
    "quick_think_llm": "gpt-4o-mini",

    # Debate rounds
    "max_debate_rounds": 1,
    "max_risk_discuss_rounds": 1,

    # Data vendors (stock layer, legacy)
    "data_vendors": {
        "core_stock_apis": "yfinance",
        "technical_indicators": "yfinance",
        "fundamental_data": "yfinance",
        "news_data": "yfinance",
    },
}