tradingagents-finzdata 0.1.0__tar.gz

tradingagents_finzdata-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FinzData
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tradingagents_finzdata-0.1.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: tradingagents-finzdata
+Version: 0.1.0
+Summary: FinzData as a data vendor for TradingAgents: point-in-time, survivorship-free prices, SEC statements as filed and macro without look-ahead.
+Author-email: FinzData <info@finzdata.com>
+License: MIT
+Project-URL: Homepage, https://finzdata.com/tradingagents
+Project-URL: Documentation, https://finzdata.com/docs
+Project-URL: Source, https://github.com/FinzData/tradingagents-finzdata
+Keywords: tradingagents,finzdata,market-data,backtesting,llm,agents,point-in-time,survivorship-bias
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: finzdata>=0.1.14
+Requires-Dist: pandas>=2.0
+Provides-Extra: tradingagents
+Requires-Dist: tradingagents; extra == "tradingagents"
+Dynamic: license-file
+
+# tradingagents-finzdata
+
+FinzData as a data vendor for TradingAgents (https://github.com/TauricResearch/TradingAgents): point-in-time, survivorship-free data so your agents' backtests hold up.
+
+## Why FinzData
+
+TradingAgents' default price vendor only knows stocks that still trade, so backtests silently drop the failures (survivorship bias). FinzData includes delisted stocks, point in time. Macro values are served as known on the analysis date (no look-ahead from later revisions). Statements as filed with the SEC.
+
+## Coverage
+
+16,000+ US stocks that have traded on NYSE and Nasdaq since January 2000, delisted included, point in time; 231 ETFs; 139 futures markets with every contract since 2007; GEX for single stocks, ETFs and the major indexes; COT since 1986; 13F; SEC fundamentals as filed; 18,000+ macro series with every vintage kept; crypto since 2015.
+
+## Install
+
+`pip install tradingagents-finzdata` and set `FINZDATA_API_KEY` (free key, email only, 12 months of data: https://finzdata.com/account?ref=tradingagents ; full history from $19 per ticker or $195 for 5 years of the whole US market, yours to keep: https://finzdata.com/shop?ref=tradingagents).
+
+## Quick start
+
+```python
+from tradingagents.graph.trading_graph import TradingAgentsGraph
+from tradingagents_finzdata import register, finzdata_config
+register()                      # adds "finzdata" as a vendor
+config = finzdata_config()      # prices, indicators, fundamentals and macro from FinzData
+ta = TradingAgentsGraph(debug=True, config=config)
+_, decision = ta.propagate("NVDA", "2024-05-10")
+print(decision)
+```
+
+## Mix and match
+
+Use FinzData as primary with fallback:
+
+config["data_vendors"]["core_stock_apis"] = "finzdata,yfinance"
+
+Tool-level override:
+
+config["tool_vendors"]["get_macro_indicators"] = "finzdata"
+
+## Tool mapping
+
+| TradingAgents tool | FinzData source |
+|---|---|
+| get_stock_data | daily bars |
+| get_indicators | computed from FinzData bars: close_50_sma, close_200_sma, close_10_ema, macd, macds, macdh, rsi, boll, boll_ub, boll_lb, atr, vwma |
+| get_balance_sheet / get_cashflow / get_income_statement | SEC statements as filed, as of the analysis date |
+| get_fundamentals | profile + point-in-time valuation |
+| get_insider_transactions | SEC Form 4 |
+| get_macro_indicators | 18,000+ series, point in time, aliases cpi, core_cpi, pce, unemployment, payrolls, gdp, fed_funds, 10y_treasury, 2y_treasury, yield_curve, m2, initial_claims |
+
+## Errors
+
+missing key -> vendor not configured (next vendor in your chain is used); history beyond your plan -> vendor unavailable with a link, never a fake "no data".
+
+## Also
+
+The FinzData MCP server https://api.finzdata.com/mcp for Claude, ChatGPT and Cursor; docs https://finzdata.com/docs.
+
+MIT licence. "FinzData is not affiliated with TauricResearch or the TradingAgents project." Support info@finzdata.com.
+
+FinzData: built for AI, quants, data scientists and financial analysts who backtest. Clean data. Real insights. Real alpha.

tradingagents_finzdata-0.1.0/README.md

@@ -0,0 +1,60 @@
+# tradingagents-finzdata
+
+FinzData as a data vendor for TradingAgents (https://github.com/TauricResearch/TradingAgents): point-in-time, survivorship-free data so your agents' backtests hold up.
+
+## Why FinzData
+
+TradingAgents' default price vendor only knows stocks that still trade, so backtests silently drop the failures (survivorship bias). FinzData includes delisted stocks, point in time. Macro values are served as known on the analysis date (no look-ahead from later revisions). Statements as filed with the SEC.
+
+## Coverage
+
+16,000+ US stocks that have traded on NYSE and Nasdaq since January 2000, delisted included, point in time; 231 ETFs; 139 futures markets with every contract since 2007; GEX for single stocks, ETFs and the major indexes; COT since 1986; 13F; SEC fundamentals as filed; 18,000+ macro series with every vintage kept; crypto since 2015.
+
+## Install
+
+`pip install tradingagents-finzdata` and set `FINZDATA_API_KEY` (free key, email only, 12 months of data: https://finzdata.com/account?ref=tradingagents ; full history from $19 per ticker or $195 for 5 years of the whole US market, yours to keep: https://finzdata.com/shop?ref=tradingagents).
+
+## Quick start
+
+```python
+from tradingagents.graph.trading_graph import TradingAgentsGraph
+from tradingagents_finzdata import register, finzdata_config
+register()                      # adds "finzdata" as a vendor
+config = finzdata_config()      # prices, indicators, fundamentals and macro from FinzData
+ta = TradingAgentsGraph(debug=True, config=config)
+_, decision = ta.propagate("NVDA", "2024-05-10")
+print(decision)
+```
+
+## Mix and match
+
+Use FinzData as primary with fallback:
+
+config["data_vendors"]["core_stock_apis"] = "finzdata,yfinance"
+
+Tool-level override:
+
+config["tool_vendors"]["get_macro_indicators"] = "finzdata"
+
+## Tool mapping
+
+| TradingAgents tool | FinzData source |
+|---|---|
+| get_stock_data | daily bars |
+| get_indicators | computed from FinzData bars: close_50_sma, close_200_sma, close_10_ema, macd, macds, macdh, rsi, boll, boll_ub, boll_lb, atr, vwma |
+| get_balance_sheet / get_cashflow / get_income_statement | SEC statements as filed, as of the analysis date |
+| get_fundamentals | profile + point-in-time valuation |
+| get_insider_transactions | SEC Form 4 |
+| get_macro_indicators | 18,000+ series, point in time, aliases cpi, core_cpi, pce, unemployment, payrolls, gdp, fed_funds, 10y_treasury, 2y_treasury, yield_curve, m2, initial_claims |
+
+## Errors
+
+missing key -> vendor not configured (next vendor in your chain is used); history beyond your plan -> vendor unavailable with a link, never a fake "no data".
+
+## Also
+
+The FinzData MCP server https://api.finzdata.com/mcp for Claude, ChatGPT and Cursor; docs https://finzdata.com/docs.
+
+MIT licence. "FinzData is not affiliated with TauricResearch or the TradingAgents project." Support info@finzdata.com.
+
+FinzData: built for AI, quants, data scientists and financial analysts who backtest. Clean data. Real insights. Real alpha.

tradingagents_finzdata-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tradingagents-finzdata"
+version = "0.1.0"
+description = "FinzData as a data vendor for TradingAgents: point-in-time, survivorship-free prices, SEC statements as filed and macro without look-ahead."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "FinzData", email = "info@finzdata.com" }]
+requires-python = ">=3.10"
+dependencies = ["finzdata>=0.1.14", "pandas>=2.0"]
+keywords = ["tradingagents", "finzdata", "market-data", "backtesting", "llm", "agents", "point-in-time", "survivorship-bias"]
+classifiers = [
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Intended Audience :: Financial and Insurance Industry",
+  "Topic :: Office/Business :: Financial :: Investment",
+]
+
+[project.optional-dependencies]
+tradingagents = ["tradingagents"]
+
+[project.urls]
+Homepage = "https://finzdata.com/tradingagents"
+Documentation = "https://finzdata.com/docs"
+Source = "https://github.com/FinzData/tradingagents-finzdata"
+
+[tool.setuptools]
+packages = ["tradingagents_finzdata"]

tradingagents_finzdata-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tradingagents_finzdata-0.1.0/tradingagents_finzdata/__init__.py

@@ -0,0 +1,460 @@
+"""
+FinzData vendor for TradingAgents.
+
+Usage:
+    from finzdata.integrations.tradingagents.tradingagents_finzdata import register, finzdata_config
+    register()
+    config = finzdata_config()
+    from tradingagents.graph import TradingAgentsGraph
+    graph = TradingAgentsGraph(config=config)
+"""
+
+from __future__ import annotations
+
+import copy
+import os
+from datetime import date, datetime, timedelta
+from typing import Any, Callable, Dict, List, Optional
+
+import pandas as pd
+
+VENDOR = "finzdata"
+__version__ = "0.1.0"
+
+_CLIENT: Optional[Any] = None
+
+
+def set_client(client: Any) -> None:
+    """Set a custom FinzData client instance."""
+    global _CLIENT
+    _CLIENT = client
+
+
+def _client() -> Any:
+    """Get or create the FinzData client."""
+    global _CLIENT
+    if _CLIENT is not None:
+        return _CLIENT
+    # Lazy import to avoid network at import time
+    import finzdata
+    _CLIENT = finzdata.Client()
+    return _CLIENT
+
+
+def _call(fn: Callable[..., Any], *args: Any, **kwargs: Any) -> Any:
+    """Call a client method with exception mapping."""
+    try:
+        return fn(*args, **kwargs)
+    except ValueError:
+        raise  # bad arguments (e.g. unknown indicator); VendorNotConfiguredError is also a ValueError
+    except Exception as e:
+        try:
+            from tradingagents.dataflows.errors import VendorError
+            if isinstance(e, VendorError):
+                raise  # already a TradingAgents verdict (no data / unavailable / not configured)
+        except ImportError:
+            pass
+        # Map FinzError with status attribute
+        status = getattr(e, "status", None)
+        if status in (401, 403):
+            from tradingagents.dataflows.errors import VendorNotConfiguredError
+            raise VendorNotConfiguredError(
+                "FinzData needs an API key: set FINZDATA_API_KEY. Free key (email only, 12 months "
+                "of data): https://finzdata.com/account?ref=tradingagents"
+            ) from e
+        if status == 402:
+            from tradingagents.dataflows.errors import VendorUnavailableError
+            raise VendorUnavailableError(
+                "FinzData returned no rows for this range. Free accounts cover the last 12 months; "
+                "every US stock since 2000 (delisted included) is at "
+                "https://finzdata.com/shop?ref=tradingagents . This says nothing about the symbol."
+            ) from e
+        if status == 429 or (status is not None and status >= 500):
+            from tradingagents.dataflows.errors import VendorUnavailableError
+            raise VendorUnavailableError(f"FinzData unavailable: {e}") from e
+        # Network errors or other exceptions
+        from tradingagents.dataflows.errors import VendorUnavailableError
+        raise VendorUnavailableError(f"FinzData unavailable: {e}") from e
+
+
+def get_stock_data(symbol: str, start_date: str, end_date: str) -> str:
+    """Get stock price data from FinzData."""
+    from tradingagents.dataflows.errors import NoMarketDataError, VendorUnavailableError
+
+    client = _client()
+    df = _call(client.prices, symbol, start=start_date, end=end_date)
+
+    if df is None or df.empty:
+        # Check if start_date is more than 365 days before today
+        try:
+            start_dt = datetime.strptime(start_date, "%Y-%m-%d").date()
+            if (date.today() - start_dt).days > 365:
+                raise VendorUnavailableError(
+                    "FinzData returned no rows for this range. Free accounts cover the last 12 months; "
+                    "every US stock since 2000 (delisted included) is at "
+                    "https://finzdata.com/shop?ref=tradingagents . This says nothing about the symbol."
+                )
+        except ValueError:
+            pass
+        raise NoMarketDataError(symbol, symbol, f"no FinzData rows between {start_date} and {end_date}")
+
+    # Ensure date column is string YYYY-MM-DD
+    df = df.copy()
+    if "date" in df.columns:
+        df["date"] = pd.to_datetime(df["date"]).dt.strftime("%Y-%m-%d")
+    # Filter date <= end_date
+    df = df[df["date"] <= end_date]
+    # Round prices to 2 decimals
+    for col in ["open", "high", "low", "close"]:
+        if col in df.columns:
+            df[col] = df[col].round(2)
+    # Select and order columns
+    if "volume" in df.columns:
+        df["volume"] = pd.to_numeric(df["volume"], errors="coerce").round().astype("Int64")
+    cols = ["date", "open", "high", "low", "close", "volume"]
+    df = df[cols]
+    # Rename columns to match expected CSV header: Date,Open,High,Low,Close,Volume
+    df.columns = ["Date", "Open", "High", "Low", "Close", "Volume"]
+    # Header
+    header = (
+        f"# Stock data for {symbol.upper()} from {start_date} to {end_date} "
+        f"(FinzData: point in time, delisted included)\n"
+        f"# Total records: {len(df)}\n\n"
+    )
+    csv_data = df.to_csv(index=False, header=True)
+    return header + csv_data
+
+
+def get_indicators(symbol: str, indicator: str, as_of_date: str, look_back_days: int) -> str:
+    """Get technical indicator values from FinzData."""
+    from tradingagents.dataflows.errors import NoMarketDataError, VendorUnavailableError
+
+    supported = {
+        "close_50_sma": "50-day Simple Moving Average of close",
+        "close_200_sma": "200-day Simple Moving Average of close",
+        "close_10_ema": "10-day Exponential Moving Average of close",
+        "macd": "MACD line (EMA 12 - EMA 26)",
+        "macds": "MACD signal line (9-day EMA of MACD)",
+        "macdh": "MACD histogram (MACD - signal)",
+        "rsi": "Relative Strength Index (14-day Wilder)",
+        "boll": "Bollinger Bands middle (20-day SMA)",
+        "boll_ub": "Bollinger Bands upper (20-day SMA + 2 std)",
+        "boll_lb": "Bollinger Bands lower (20-day SMA - 2 std)",
+        "atr": "Average True Range (14-day)",
+        "vwma": "Volume Weighted Moving Average (20-day)",
+    }
+
+    if indicator not in supported:
+        raise ValueError(
+            f"Unsupported indicator: {indicator}. Supported: {', '.join(sorted(supported.keys()))}"
+        )
+
+    client = _client()
+    as_of_dt = datetime.strptime(as_of_date, "%Y-%m-%d").date()
+    start_dt = as_of_dt - timedelta(days=look_back_days + 400)
+    start_str = start_dt.strftime("%Y-%m-%d")
+
+    df = _call(client.prices, symbol, start=start_str, end=as_of_date)
+
+    if df is None or df.empty:
+        raise NoMarketDataError(symbol, symbol, f"no FinzData rows for indicator calculation")
+
+    df = df.copy()
+    df["date"] = pd.to_datetime(df["date"])
+    df = df.sort_values("date")
+
+    close = df["close"]
+    high = df["high"]
+    low = df["low"]
+    volume = df["volume"]
+
+    # Compute indicators
+    if indicator == "close_50_sma":
+        values = close.rolling(50).mean()
+    elif indicator == "close_200_sma":
+        values = close.rolling(200).mean()
+    elif indicator == "close_10_ema":
+        values = close.ewm(span=10, adjust=False).mean()
+    elif indicator == "macd":
+        ema12 = close.ewm(span=12, adjust=False).mean()
+        ema26 = close.ewm(span=26, adjust=False).mean()
+        values = ema12 - ema26
+    elif indicator == "macds":
+        ema12 = close.ewm(span=12, adjust=False).mean()
+        ema26 = close.ewm(span=26, adjust=False).mean()
+        macd_line = ema12 - ema26
+        values = macd_line.ewm(span=9, adjust=False).mean()
+    elif indicator == "macdh":
+        ema12 = close.ewm(span=12, adjust=False).mean()
+        ema26 = close.ewm(span=26, adjust=False).mean()
+        macd_line = ema12 - ema26
+        signal = macd_line.ewm(span=9, adjust=False).mean()
+        values = macd_line - signal
+    elif indicator == "rsi":
+        delta = close.diff()
+        gain = delta.where(delta > 0, 0.0)
+        loss = -delta.where(delta < 0, 0.0)
+        avg_gain = gain.ewm(alpha=1/14, adjust=False).mean()
+        avg_loss = loss.ewm(alpha=1/14, adjust=False).mean()
+        rs = avg_gain / avg_loss
+        values = 100 - (100 / (1 + rs))
+    elif indicator == "boll":
+        values = close.rolling(20).mean()
+    elif indicator == "boll_ub":
+        sma20 = close.rolling(20).mean()
+        std20 = close.rolling(20).std()
+        values = sma20 + 2 * std20
+    elif indicator == "boll_lb":
+        sma20 = close.rolling(20).mean()
+        std20 = close.rolling(20).std()
+        values = sma20 - 2 * std20
+    elif indicator == "atr":
+        prev_close = close.shift(1)
+        tr1 = high - low
+        tr2 = (high - prev_close).abs()
+        tr3 = (low - prev_close).abs()
+        tr = pd.concat([tr1, tr2, tr3], axis=1).max(axis=1)
+        values = tr.ewm(alpha=1/14, adjust=False).mean()
+    elif indicator == "vwma":
+        pv = close * volume
+        values = pv.rolling(20).sum() / volume.rolling(20).sum()
+    else:
+        raise ValueError(f"Unsupported indicator: {indicator}")
+
+    # Filter to look-back window (trading days only, newest first)
+    df["value"] = values
+    window_start = as_of_dt - timedelta(days=look_back_days)  # warm-up rows above feed the calculation only
+    df = df[df["date"] >= pd.Timestamp(window_start)]
+    df = df[df["date"] <= pd.Timestamp(as_of_dt)]
+    df = df.dropna(subset=["value"])
+    df = df.sort_values("date", ascending=False)
+
+    lines = [f"{row['date'].strftime('%Y-%m-%d')}: {row['value']:.4f}" for _, row in df.iterrows()]
+
+    header = f"## {indicator} values from {window_start} to {as_of_date} (FinzData):\n\n"
+    body = "\n".join(lines)
+    footer = f"\n\n{supported[indicator]}"
+    return header + body + footer
+
+
+def get_balance_sheet(ticker: str, freq: str = "quarterly", as_of_date: Optional[str] = None) -> str:
+    """Get balance sheet from FinzData."""
+    from tradingagents.dataflows.errors import NoMarketDataError
+
+    client = _client()
+    df = _call(client.statements, ticker, statement="balance", freq=freq, as_of=as_of_date)
+
+    if df is None or df.empty:
+        raise NoMarketDataError(ticker, ticker, f"no balance sheet data for {ticker}")
+
+    as_of_str = as_of_date or "today"
+    header = (
+        f"# Balance sheet for {ticker.upper()} ({freq}), as filed with the SEC, "
+        f"known as of {as_of_str} (FinzData)\n\n"
+    )
+    return header + df.to_csv(index=False)
+
+
+def get_cashflow(ticker: str, freq: str = "quarterly", as_of_date: Optional[str] = None) -> str:
+    """Get cash flow statement from FinzData."""
+    from tradingagents.dataflows.errors import NoMarketDataError
+
+    client = _client()
+    df = _call(client.statements, ticker, statement="cashflow", freq=freq, as_of=as_of_date)
+
+    if df is None or df.empty:
+        raise NoMarketDataError(ticker, ticker, f"no cash flow data for {ticker}")
+
+    as_of_str = as_of_date or "today"
+    header = (
+        f"# Cash flow for {ticker.upper()} ({freq}), as filed with the SEC, "
+        f"known as of {as_of_str} (FinzData)\n\n"
+    )
+    return header + df.to_csv(index=False)
+
+
+def get_income_statement(ticker: str, freq: str = "quarterly", as_of_date: Optional[str] = None) -> str:
+    """Get income statement from FinzData."""
+    from tradingagents.dataflows.errors import NoMarketDataError
+
+    client = _client()
+    df = _call(client.statements, ticker, statement="income", freq=freq, as_of=as_of_date)
+
+    if df is None or df.empty:
+        raise NoMarketDataError(ticker, ticker, f"no income statement data for {ticker}")
+
+    as_of_str = as_of_date or "today"
+    header = (
+        f"# Income statement for {ticker.upper()} ({freq}), as filed with the SEC, "
+        f"known as of {as_of_str} (FinzData)\n\n"
+    )
+    return header + df.to_csv(index=False)
+
+
+def get_fundamentals(ticker: str, as_of_date: Optional[str] = None) -> str:
+    """Get company fundamentals from FinzData."""
+    from tradingagents.dataflows.errors import NoMarketDataError
+
+    client = _client()
+    profile_df = _call(client.profile, symbol=ticker)
+    valuation_df = _call(client.valuation, ticker, end=as_of_date)
+
+    if (profile_df is None or profile_df.empty) and (valuation_df is None or valuation_df.empty):
+        raise NoMarketDataError(ticker, ticker, f"no fundamentals data for {ticker}")
+
+    as_of_str = as_of_date or "today"
+    header = f"# Company fundamentals for {ticker.upper()} as of {as_of_str} (FinzData)\n\n"
+
+    lines = []
+    if profile_df is not None and not profile_df.empty:
+        row = profile_df.iloc[0]
+        for col in ["name", "sector", "industry"]:
+            if col in row and pd.notna(row[col]):
+                lines.append(f"{col}: {row[col]}")
+
+    if valuation_df is not None and not valuation_df.empty:
+        row = valuation_df.iloc[-1]  # latest row
+        for col in valuation_df.columns:
+            if pd.notna(row[col]):
+                lines.append(f"{col}: {row[col]}")
+
+    return header + "\n".join(lines) + "\n"
+
+
+def get_insider_transactions(ticker: str, as_of_date: Optional[str] = None) -> str:
+    """Get insider transactions from FinzData."""
+    from tradingagents.dataflows.errors import NoMarketDataError
+
+    client = _client()
+    df = _call(client.insider_transactions, ticker=ticker, end=as_of_date, limit=200)
+
+    if df is None or df.empty:
+        raise NoMarketDataError(ticker, ticker, f"no insider transactions for {ticker}")
+
+    if as_of_date and "filed" in df.columns:  # point in time: only Form 4s already public on the analysis date
+        df = df[pd.to_datetime(df["filed"]) <= pd.Timestamp(as_of_date)]
+        if df.empty:
+            raise NoMarketDataError(ticker, ticker, f"no Form 4 filings for {ticker} public by {as_of_date}")
+    if "filed" in df.columns:
+        df = df.sort_values("filed", ascending=False)
+    df = df.head(50)  # newest 50 rows
+    header = (f"# Insider transactions for {ticker.upper()} (FinzData, SEC Form 4)\n"
+              f"# Point in time: only filings public by {as_of_date or 'today'} (column 'filed')\n\n")
+    return header + df.to_csv(index=False)
+
+
+def get_macro_indicators(
+    indicator: str,
+    as_of_date: str,
+    look_back_days: Optional[int] = None
+) -> str:
+    """Get macro indicators from FinzData."""
+    from tradingagents.dataflows.errors import NoMarketDataError, VendorUnavailableError
+
+    aliases = {
+        "cpi": "CPIAUCSL",
+        "core_cpi": "CPILFESL",
+        "pce": "PCEPI",
+        "unemployment": "UNRATE",
+        "payrolls": "PAYEMS",
+        "gdp": "GDP",
+        "fed_funds": "FEDFUNDS",
+        "10y_treasury": "DGS10",
+        "2y_treasury": "DGS2",
+        "yield_curve": "T10Y2Y",
+        "m2": "M2SL",
+        "initial_claims": "ICSA",
+    }
+
+    indicator_lower = indicator.lower()
+    series = aliases.get(indicator_lower, indicator.upper())
+
+    client = _client()
+    as_of_dt = datetime.strptime(as_of_date, "%Y-%m-%d").date()
+    lb = look_back_days if look_back_days is not None else 365
+    start_dt = as_of_dt - timedelta(days=lb)
+    start_str = start_dt.strftime("%Y-%m-%d")
+
+    df = _call(
+        client.macro,
+        series,
+        start=start_str,
+        end=as_of_date,
+        vintage="latest",
+        as_of=as_of_date,
+    )
+
+    if df is None or df.empty:
+        raise NoMarketDataError(series, series, f"no macro data for {series}")
+
+    df = df.copy()
+    if "date" in df.columns:
+        df["date"] = pd.to_datetime(df["date"])
+    df = df.sort_values("date", ascending=False)
+    df = df.head(24)  # newest 24 rows
+
+    latest_row = df.iloc[0]
+    oldest_row = df.iloc[-1]
+    latest_val = latest_row.get("value", latest_row.iloc[-1])
+    latest_date = latest_row.get("date", latest_row.iloc[0])
+    oldest_val = oldest_row.get("value", oldest_row.iloc[-1])
+    change = latest_val - oldest_val
+
+    header = f"## {series} as known on {as_of_date} (FinzData, point in time)\n\n"
+    header += f"- Latest: {latest_val} ({latest_date.strftime('%Y-%m-%d') if hasattr(latest_date, 'strftime') else latest_date})\n"
+    header += f"- Change over window: {change}\n\n"
+    header += "| Date | Value |\n|---|---|\n"
+
+    rows = []
+    for _, row in df.iterrows():
+        d = row.get("date", row.iloc[0])
+        v = row.get("value", row.iloc[-1])
+        date_str = d.strftime("%Y-%m-%d") if hasattr(d, "strftime") else str(d)
+        rows.append(f"| {date_str} | {v} |")
+
+    return header + "\n".join(rows) + "\n"
+
+
+def register() -> List[str]:
+    """Register FinzData vendor functions with TradingAgents router."""
+    from tradingagents.dataflows import router
+
+    methods = [
+        "get_stock_data",
+        "get_indicators",
+        "get_balance_sheet",
+        "get_cashflow",
+        "get_income_statement",
+        "get_fundamentals",
+        "get_insider_transactions",
+        "get_macro_indicators",
+    ]
+
+    for method in methods:
+        fn = globals()[method]
+        router.VENDOR_METHODS.setdefault(method, {})[VENDOR] = fn
+
+    return methods
+
+
+def finzdata_config(base: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+    """Create a TradingAgents config with FinzData as the data vendor."""
+    if base is not None:
+        config = copy.deepcopy(base)
+    else:
+        try:
+            from tradingagents.default_config import DEFAULT_CONFIG
+            config = copy.deepcopy(DEFAULT_CONFIG)
+        except Exception:
+            config = {}
+
+    config.setdefault("data_vendors", {})
+    config["data_vendors"]["core_stock_apis"] = "finzdata"
+    config["data_vendors"]["technical_indicators"] = "finzdata"
+    config["data_vendors"]["fundamental_data"] = "finzdata,sec_edgar"
+    config["data_vendors"]["macro_data"] = "finzdata"
+    # Insider trades route through the news category; FinzData's Form 4 rows carry the filing date, so they can be
+    # served point in time (TradingAgents withholds vendors that cannot).
+    config.setdefault("tool_vendors", {})["get_insider_transactions"] = "finzdata"
+
+    return config

tradingagents_finzdata-0.1.0/tradingagents_finzdata.egg-info/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: tradingagents-finzdata
+Version: 0.1.0
+Summary: FinzData as a data vendor for TradingAgents: point-in-time, survivorship-free prices, SEC statements as filed and macro without look-ahead.
+Author-email: FinzData <info@finzdata.com>
+License: MIT
+Project-URL: Homepage, https://finzdata.com/tradingagents
+Project-URL: Documentation, https://finzdata.com/docs
+Project-URL: Source, https://github.com/FinzData/tradingagents-finzdata
+Keywords: tradingagents,finzdata,market-data,backtesting,llm,agents,point-in-time,survivorship-bias
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: finzdata>=0.1.14
+Requires-Dist: pandas>=2.0
+Provides-Extra: tradingagents
+Requires-Dist: tradingagents; extra == "tradingagents"
+Dynamic: license-file
+
+# tradingagents-finzdata
+
+FinzData as a data vendor for TradingAgents (https://github.com/TauricResearch/TradingAgents): point-in-time, survivorship-free data so your agents' backtests hold up.
+
+## Why FinzData
+
+TradingAgents' default price vendor only knows stocks that still trade, so backtests silently drop the failures (survivorship bias). FinzData includes delisted stocks, point in time. Macro values are served as known on the analysis date (no look-ahead from later revisions). Statements as filed with the SEC.
+
+## Coverage
+
+16,000+ US stocks that have traded on NYSE and Nasdaq since January 2000, delisted included, point in time; 231 ETFs; 139 futures markets with every contract since 2007; GEX for single stocks, ETFs and the major indexes; COT since 1986; 13F; SEC fundamentals as filed; 18,000+ macro series with every vintage kept; crypto since 2015.
+
+## Install
+
+`pip install tradingagents-finzdata` and set `FINZDATA_API_KEY` (free key, email only, 12 months of data: https://finzdata.com/account?ref=tradingagents ; full history from $19 per ticker or $195 for 5 years of the whole US market, yours to keep: https://finzdata.com/shop?ref=tradingagents).
+
+## Quick start
+
+```python
+from tradingagents.graph.trading_graph import TradingAgentsGraph
+from tradingagents_finzdata import register, finzdata_config
+register()                      # adds "finzdata" as a vendor
+config = finzdata_config()      # prices, indicators, fundamentals and macro from FinzData
+ta = TradingAgentsGraph(debug=True, config=config)
+_, decision = ta.propagate("NVDA", "2024-05-10")
+print(decision)
+```
+
+## Mix and match
+
+Use FinzData as primary with fallback:
+
+config["data_vendors"]["core_stock_apis"] = "finzdata,yfinance"
+
+Tool-level override:
+
+config["tool_vendors"]["get_macro_indicators"] = "finzdata"
+
+## Tool mapping
+
+| TradingAgents tool | FinzData source |
+|---|---|
+| get_stock_data | daily bars |
+| get_indicators | computed from FinzData bars: close_50_sma, close_200_sma, close_10_ema, macd, macds, macdh, rsi, boll, boll_ub, boll_lb, atr, vwma |
+| get_balance_sheet / get_cashflow / get_income_statement | SEC statements as filed, as of the analysis date |
+| get_fundamentals | profile + point-in-time valuation |
+| get_insider_transactions | SEC Form 4 |
+| get_macro_indicators | 18,000+ series, point in time, aliases cpi, core_cpi, pce, unemployment, payrolls, gdp, fed_funds, 10y_treasury, 2y_treasury, yield_curve, m2, initial_claims |
+
+## Errors
+
+missing key -> vendor not configured (next vendor in your chain is used); history beyond your plan -> vendor unavailable with a link, never a fake "no data".
+
+## Also
+
+The FinzData MCP server https://api.finzdata.com/mcp for Claude, ChatGPT and Cursor; docs https://finzdata.com/docs.
+
+MIT licence. "FinzData is not affiliated with TauricResearch or the TradingAgents project." Support info@finzdata.com.
+
+FinzData: built for AI, quants, data scientists and financial analysts who backtest. Clean data. Real insights. Real alpha.

tradingagents_finzdata-0.1.0/tradingagents_finzdata.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+tradingagents_finzdata/__init__.py
+tradingagents_finzdata.egg-info/PKG-INFO
+tradingagents_finzdata.egg-info/SOURCES.txt
+tradingagents_finzdata.egg-info/dependency_links.txt
+tradingagents_finzdata.egg-info/requires.txt
+tradingagents_finzdata.egg-info/top_level.txt

tradingagents_finzdata-0.1.0/tradingagents_finzdata.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tradingagents_finzdata-0.1.0/tradingagents_finzdata.egg-info/requires.txt

@@ -0,0 +1,5 @@
+finzdata>=0.1.14
+pandas>=2.0
+
+[tradingagents]
+tradingagents

tradingagents_finzdata-0.1.0/tradingagents_finzdata.egg-info/top_level.txt

@@ -0,0 +1 @@
+tradingagents_finzdata