Append pending entry at end of propagate(). No LLM call. ``rating`` is the decision's own rating when the caller has it; without one

Parse all entries from log. Returns list of dicts.

Update the configuration with custom values. Dict-valued keys (e.g. ``data_vendors``) are merged one level deep so a partial update like ``{"

Resolve capabilities by exact ID, then pattern, then default.

Map a user/broker symbol to its canonical Yahoo Finance symbol. Resolution order (first match wins): 1. Explicit alias table (metals, energ

Return formatted past context string for agent prompt injection. When ``as_of`` (yyyy-mm-dd) is given, only lessons whose outcome was

Extract a 5-tier rating, or ``REVIEW`` when the decision has none. For callers that need a string for every decision, such as the memory log's

Get the configuration of the run in progress, else the process-wide one.

Replace pending tag and append REFLECTION section using atomic write. Returns whether an entry was updated: False when the decision was no

Return the instrument context for the current run. Prefers the identity-resolved context computed once at run start and stored on the state (

Return a prompt instruction for the configured output language. Returns empty string when English (default), so no extra tokens are used. App

A quote feed answering ``articles``, and a search answering the rest. By default the search knows the symbol but has no articles, i.e. Yahoo answ

Create an LLM client for the specified provider. Provider modules are imported lazily so that simply importing this factory (e.g. during test

Validate ``value`` is safe to interpolate into a filesystem path. Tickers come from user CLI input or from LLM tool calls, both of which can

Extract a 5-tier rating from its label, or ``None`` if there is none. Reads an explicit "Rating: X" label (tolerant of markdown bold) in the

Save a completed run's reports to ``save_path``; return the complete-report path. ``settings`` (``TradingAgentsGraph.run_settings()``) adds what

The date a tool serves: the model's date, but never later than the run's. A model can omit the date or pass today's instead of the analysis date,

Keyword arguments for ``create_llm_client`` from a TradingAgents config.

Today's date, YYYY-MM-DD.

Route method calls to appropriate vendor implementation with fallback support.

Analyze every ticker on every date, into a memory log of this run's own. The live log stays untouched: a sweep would otherwise flood the context

Score the settled decisions of a backtest, or of a memory log at a path, by rating.

Check if model name is valid for the given provider. For ollama, openrouter, and openai_compatible - any model is accepted.

Epoch seconds for UTC midnight of ``date_str`` (host-timezone independent).

Return entries with outcome:pending, for settlement.

Whether an item belongs in the half-open window ``[start, end + 1 day)``. ``pub_dt`` None means undated: kept only when the window reaches the pr

Execute a yfinance call with exponential backoff on rate limits. yfinance raises YFRateLimitError on HTTP 429 responses but does not retry th

The defaults as the environment given here would set them.

Helper function to make API requests and handle responses. Raises: AlphaVantageRateLimitError: When API rate limit is exceeded

Describe the exact instrument so agents preserve identity and ticker. When ``identity`` is provided (resolved deterministically via :func:`re

Return the env var name for `provider`'s API key, or None if not applicable. Unknown providers also return None — callers should treat that as

Deterministic thread ID for a ticker+date pair. ``signature`` folds in graph-shape-affecting run choices so a resume under a different graph

Store a decision then immediately resolve it via the API.

Resolve deterministic identity metadata (company name, sector, …) for a ticker. This exists to stop the pipeline from hallucinating a *different*

A get_closes stand-in serving each symbol's series between the dates asked.

Run inputs that must invalidate a checkpoint if changed. Keyed into the checkpoint thread ID so a resume under a different analyst se

Placeholder for a window a feed did not fully observe, else None. Yahoo news and the Reddit and StockTwits feeds return their latest items wh

Return the crypto base (e.g. ``BTC``) for a known USD/USDT/USDC-quoted crypto symbol in any form the pipeline may hold — ``BTC-USD``, ``BTCUSD``,

Return the caller's portfolio block, or a notice that none was given. A run without portfolio context must not read as a flat book: the agents

The previous run's answers, or an empty dict when there is nothing usable. Convenience state: an unreadable or corrupt file means no defaults, ne

A finished run's rating: the Portfolio Manager's own, else read from its decision. The fallback serves a state without ``final_rating``, such as

Reject OHLCV whose latest row is far older than as_of_date. Raises NoMarketDataError (with a stale-specific detail) so the router treats it l

Extract bind() kwargs from a with_structured_output result.

Validate an ``llm_max_retries`` value to a non-negative int. Accepts an int or a numeric string (env vars arrive as strings). Rejects boolean

Validate a ``max_tokens`` value to a positive int (env vars are strings).

OHLCV frame whose date column is named `date_col`.

Return the step number of the latest checkpoint, or None if none exists.

Create a sentiment analyst node for the trading graph. Pre-fetches news + StockTwits + Reddit data, injects them into the prompt as structure

Context manager yielding a SqliteSaver backed by a per-ticker DB.

Whether a run is dated before today, so live-only data would come from after it.

Opponent's latest argument, or an explicit opening marker when empty. The first speaker in each debate round receives an empty opponent response;

Keep only the remembered answers that are still choosable now.

Warn when the model is outside the known list for the provider.

LLM whose structured binding records the prompt it was handed.

Flatten a captured prompt (str, message list, or objects) to text.

Build a _request replacement that dispatches on the endpoint path.

Drive load_ohlcv against a pre-seeded cache frame (no network).

Write a completed entry directly to file, bypassing the API.