Drop financial statement columns (fiscal period timestamps) after curr_date. yfinance financial statements use fiscal period end dates as columns

Return shared model options for a provider and selection mode.

Initialize the configuration with default values.

Fetch OHLCV data with caching, filtered to prevent look-ahead bias. Downloads 5 years of data up to today and caches per symbol. On subsequen

Render a TraderProposal to markdown. The trailing ``FINAL TRANSACTION PROPOSAL: **BUY/HOLD/SELL**`` line is preserved for backward compatibil

Determine if risk analysis should continue.

Save a completed run's reports to ``save_path``; return the complete-report path.

Drop oldest resolved blocks when their count exceeds max_entries. Pending blocks are always kept (they represent unprocessed work). R

Stub _bedrock_class so the constructor kwargs are testable without the optional langchain-aws extra installed.

Create tool nodes for different data sources using abstract methods.

Normalize the date column to ``Date``. Some yfinance builds leave the index unnamed (so ``reset_index()`` yields ``index``) or use ``Datetime

Extract article data from yfinance news format (handles nested 'content' structure).

Default path: parse the public Atom search feed for a subreddit. Carries no score / comment counts, so those fields are left None and the pos

Whether an article belongs in the [start_dt, end_dt] window. Dated articles are kept only if they fall in the window. An undated article is k

(display_name, provider_key, base_url) for every supported provider. Shared by the interactive picker and by env-driven configuration so an e

Gamma encodes ``outcomes``/``outcomePrices`` as JSON-string arrays.

Minimal DataFrame matching yfinance .history() output shape.

Select a model for the given provider and mode (quick/deep).

Build a MagicMock LLM whose with_structured_output binding captures the prompt and returns a real TraderProposal so render_trader_proposal works.

Whether the (native OpenAI) model accepts ``reasoning_effort``.

Apply multiple outcome updates in a single read + atomic write. Each element of updates must have keys: ticker, trade_date, raw_retur

Remove checkpoint for a specific ticker+date by deleting the thread's rows.

Convert various date formats to YYYYMMDDTHHMM format required by Alpha Vantage API.

Get arguments for the graph invocation. Args: callbacks: Optional list of callback handlers for tool execution tracking.

Build known model names from the shared CLI catalog.

Return a configured ChatOpenAI instance, driven by the provider registry.

Whether ``provider`` is served by the OpenAI-compatible registry.

Whether a ticker entry is acceptable (charset + length). Allows the characters Yahoo symbols use, including ``=`` for futures/forex like ``GC

True when ``symbol`` only contains characters Yahoo symbols use.

Run the trading agents graph for a company on a specific date. ``asset_type`` selects between the stock pipeline (default) and the cr

Render a ResearchPlan to markdown for storage and the trader's prompt context.

Resolve the backend URL with the correct precedence. An explicit env override (``env_url``, from ``TRADINGAGENTS_LLM_BACKEND_URL`` via ``DEFA

Resolve ticker identity once and return the full instrument context. Deterministic yfinance lookup (cached, fail-open) injected into a

Write the markdown report tree for a completed run, like the CLI does. Programmatic callers get the same on-disk reports the CLI produces. Pa

Determine if debate should continue.

Apply TRADINGAGENTS_* env vars to the config dict in-place.

Lazily import langchain-aws (the optional ``[bedrock]`` extra) and return a ChatBedrockConverse subclass with normalized content output. Impo

Assemble the run config from interactive selections, honoring env precedence. Round counts and checkpoint follow "explicit env/flag wins": an env

Assemble the sentiment-analyst system message with structured data blocks.

Normalize a stock DataFrame for stockstats: parse dates, drop invalid rows, fill price gaps.

Return a trimmed string, or None for empty / placeholder-ish values.

Coerce env-var string to the type of the existing default value. Invalid values raise ``ValueError`` rather than silently falling back to a d

Return parsed dates from an OHLCV frame, whether Date is a column or the index.

Fetch available models from the OpenRouter API.

Fetch one subreddit, RSS-first. The JSON search endpoint is reliably WAF-blocked (403) for public clients, so we go straight to the RSS feed

Filter CSV data to include only rows within the specified date range. Args: csv_data: CSV string from Alpha Vantage API star

Concise prompt for reflect_on_final_decision (Phase B log entries). Produces 2-4 sentences of plain prose — compact enough to be re-injected

Optimized bulk calculation of stock stats indicators. Fetches data once and calculates indicator for all available dates. Returns dict ma

Keep only open markets that resolve in the future. ``closed`` is the reliable resolved flag (``active`` stays True even for settled markets),

Parse an Atom ``published`` timestamp to a UTC epoch, or None.

Log the final state to a JSON file.

Return ``<BASE>-USD`` for a known USD/USDT/USDC-quoted crypto, else None.

Prompt user to type a custom model ID.

GET a FRED endpoint, surfacing FRED's JSON error body on a bad request.

Map a friendly alias to a FRED series ID, or pass a raw ID through. Raises ``ValueError`` when the input is neither a known alias nor a plausible

Seconds to wait from a 429's ``Retry-After`` header, capped at 30s.

Execute the graph and write the resulting state to disk and memory log.

Map a crypto pair to StockTwits' ``<BASE>.X`` convention. StockTwits lists crypto as ``BTC.X`` (Yahoo's ``BTC-USD`` form 404s), so any crypto

Reduce the HTML body Reddit embeds in an Atom entry to plain text.

Whether Anthropic accepts the ``effort`` parameter for this model.

OHLCV on or before curr_date, date-sorted. Raises if nothing usable. ``load_ohlcv`` already normalizes the Date column and filters out look-a