Skip to content

Config

TradingAgentsConfig

Bases: BaseModel


              flowchart TD
              src.tradingagents.config.TradingAgentsConfig[TradingAgentsConfig]

              

              click src.tradingagents.config.TradingAgentsConfig href "" "src.tradingagents.config.TradingAgentsConfig"
            

Configuration for the TradingAgents framework.

results_dir

results_dir: Path = Field(
    default=Path("./results"),
    title="Results Directory",
    description="Directory for saving analysis results",
)

llm_provider

llm_provider: LLMProvider = Field(
    ...,
    title="LLM Provider",
    description="Langchain `init_chat_model` registry key shared by both deep- and quick-thinking models (e.g. `openai`, `anthropic`, `google_genai`).",
)

deep_think_llm

deep_think_llm: str = Field(
    ...,
    title="Deep Thinking LLM",
    description="Model name for deep-thinking nodes (Research Manager, Risk Manager). Example: `claude-sonnet-4-6`, `gpt-5.4`.",
)

quick_think_llm

quick_think_llm: str = Field(
    ...,
    title="Quick Thinking LLM",
    description="Model name for quick-thinking nodes (analysts, researchers, trader, debaters).",
)

reasoning_effort

reasoning_effort: ReasoningEffort = Field(
    default="medium",
    title="Reasoning Effort",
    description="Unified reasoning effort level for reasoning-capable LLMs. Mapped per-provider inside build_chat_model.",
)

response_language

response_language: ResponseLanguage = Field(
    default="en-US",
    title="Response Language",
    description="BCP 47 language tag (ISO 639-1 + ISO 3166-1 alpha-2) appended to agent prompts. Supported values: zh-TW, zh-CN, en-US, ja-JP, ko-KR, de-DE.",
)

max_debate_rounds

max_debate_rounds: int = Field(
    ...,
    title="Max Debate Rounds",
    description="Maximum number of Bull/Bear investment debate rounds",
)

max_risk_discuss_rounds

max_risk_discuss_rounds: int = Field(
    ...,
    title="Max Risk Discussion Rounds",
    description="Maximum number of risk management debate rounds",
)

max_recur_limit

max_recur_limit: int = Field(
    ...,
    ge=25,
    title="Max Recursion Limit",
    description="Maximum recursion limit for the LangGraph execution",
)

data_cache_dir

data_cache_dir: Path

Return the data cache directory under the results directory.

Returns:

Name Type Description
Path Path

Directory used for caching downloaded market and news data.