Skip to content

"Vibe-Trading: Your Personal Trading Agent"

test(loaders): wire shared OHLCV contract assertion into per-loader suites

Jackzigenb2ca55c59830
diff --git a/agent/tests/loader_contract.py b/agent/tests/loader_contract.py
new file mode 100644
index 000000000..6bc991c43
--- /dev/null
+++ b/agent/tests/loader_contract.py
@@ -0,0 +1,91 @@
+"""Shared per-loader contract assertion (issue #1723).
+
+Each loader test file pins its own canonical fixture with bespoke assertions;
+the only shared schema check lived in the weekly health lane
+(:mod:`backtest.loader_health`), at runtime. Nothing stopped a new loader, or
+a refactor of an old one, from quietly changing the frame the rest of the
+pipeline consumes.
+
+This harness pins the *structural* contract every downstream consumer relies
+on, using the same failure vocabulary as the health lane's ``check_frame``:
+
+- the frame carries unique ``open`` / ``high`` / ``low`` / ``close`` /
+ ``volume`` columns, all numeric;
+- the index is a DatetimeIndex, sorted, unique, no NaT;
+- prices positive, volume non-negative, high >= max(open, close, low),
+ low <= min(open, close), all finite.
+
+One call per loader test, on its canonical fixture. Fixtures are historic
+(frozen dates), so freshness — the only check ``check_frame`` does that is
+meaningless offline — is intentionally out of scope here; it stays in the
+weekly lane.
+"""
+
+from __future__ import annotations
+
+import pandas as pd
+import pytest
+
+OHLCV_COLUMNS = ("open", "high", "low", "close", "volume")
+
+# Structural failures that must never reach the pipeline. Same vocabulary as
+# backtest.loader_health.check_frame.
+_CONTRACT_REASONS = frozenset(
+ {
+ "empty_frame",
+ "schema",
+ "datetime_index",
+ "index_order",
+ "numeric_columns",
+ "nonfinite_values",
+ "invalid_prices_or_volume",
+ "ohlc_order",
+ }
+)
+
+
+def loader_contract_errors(frame: object, *, context: str = "") -> list[str]:
+ """Return contract violations for a normalized OHLCV frame.
+
+ Mirrors the structural half of ``backtest.loader_health.check_frame``
+ (freshness deliberately excluded — fixtures are frozen history). Never
+ raises on bad input; returns the violation list so tests can render it.
+ """
+ import numpy as np
+
+ def bad(reason: str) -> list[str]:
+ return [f"{context}: {reason}" if context else reason]
+
+ if not isinstance(frame, pd.DataFrame) or frame.empty:
+ return bad("empty_frame")
+ if not frame.columns.is_unique or not set(OHLCV_COLUMNS) <= set(frame.columns):
+ return bad("schema")
+ if not isinstance(frame.index, pd.DatetimeIndex) or frame.index.hasnans:
+ return bad("datetime_index")
+ if not frame.index.is_monotonic_increasing or not frame.index.is_unique:
+ return bad("index_order")
+ if any(not pd.api.types.is_numeric_dtype(frame[c]) for c in OHLCV_COLUMNS):
+ return bad("numeric_columns")
+ values = frame[list(OHLCV_COLUMNS)].to_numpy(dtype=float)
+ if not np.isfinite(values).all():
+ return bad("nonfinite_values")
+ if (values[:, :4] <= 0).any() or (values[:, 4] < 0).any():
+ return bad("invalid_prices_or_volume")
+ if (frame.high < frame[["open", "close", "low"]].max(axis=1)).any() or (
+ frame.low > frame[["open", "close"]].min(axis=1)
+ ).any():
+ return bad("ohlc_order")
+ return []
+
+
+def assert_loader_contract(frame: object, *, context: str = "") -> None:
+ """Assert a loader's normalized frame satisfies the shared contract.
+
+ One call per loader test, on its canonical fixture.
+ """
+ errors = loader_contract_errors(frame, context=context)
+ if errors:
+ pytest.fail(
+ "loader contract violated: " + "; ".join(errors)
+ + f"\n(frame={getattr(frame, 'shape', None)})"
+ )
diff --git a/agent/tests/test_akshare_loader.py b/agent/tests/test_akshare_loader.py
index c370b3890..4489d37a2 100644
--- a/agent/tests/test_akshare_loader.py
+++ b/agent/tests/test_akshare_loader.py
@@ -23,6 +23,15 @@ from backtest.loaders.akshare_loader import (
_is_hk,
_is_us,
)
+from backtest.loaders.akshare_loader import (
+ DataLoader,
+ _is_a_share,
+ _is_etf_listed,
+ _is_forex,
+ _is_hk,
+ _is_us,
+)
+from tests.loader_contract import assert_loader_contract
# ---------------------------------------------------------------------------
@@ -181,6 +190,7 @@ class TestRouting:
assert df is not None
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert len(df) == 2
+ assert_loader_contract(df, context="canonical frame")
def test_etf_sz_uses_sz_prefix(self, fake_akshare: SimpleNamespace) -> None:
loader = DataLoader()
diff --git a/agent/tests/test_alphavantage_loader.py b/agent/tests/test_alphavantage_loader.py
index eee170230..af9b1d9d4 100644
--- a/agent/tests/test_alphavantage_loader.py
+++ b/agent/tests/test_alphavantage_loader.py
@@ -10,6 +10,8 @@ import pandas as pd
import pytest
from backtest.loaders import alphavantage_loader as av
+from backtest.loaders import alphavantage_loader as av
+from tests.loader_contract import assert_loader_contract
def _payload(*dates_rows) -> dict:
@@ -75,6 +77,7 @@ class TestFetch:
df = out["AAPL"]
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="canonical frame")
assert isinstance(df.index, pd.DatetimeIndex)
assert df.index.is_monotonic_increasing
assert all(df[col].dtype == float for col in df.columns)
diff --git a/agent/tests/test_baostock_loader.py b/agent/tests/test_baostock_loader.py
index efe94c70f..353f5f952 100644
--- a/agent/tests/test_baostock_loader.py
+++ b/agent/tests/test_baostock_loader.py
@@ -3,6 +3,7 @@
Ensures both baostock native (sh.601398) and tushare-style (601398.SH) codes work.
"""
from backtest.loaders.baostock_loader import _is_a_share
+from tests.loader_contract import assert_loader_contract
class TestIsAShareCodeFormat:
@@ -128,6 +129,7 @@ class TestVolumeUnitNormalization:
df = loader._fetch_one(bs_mock, "601398.SH", "2024-01-01", "2024-01-31")
+ assert_loader_contract(df, context="baostock daily")
assert df["volume"].iloc[-1] == 55128.0
def test_odd_lot_volume_keeps_fractional_lots(self):
diff --git a/agent/tests/test_ccxt_loader_bounded.py b/agent/tests/test_ccxt_loader_bounded.py
index 16080047c..738ac182b 100644
--- a/agent/tests/test_ccxt_loader_bounded.py
+++ b/agent/tests/test_ccxt_loader_bounded.py
@@ -19,6 +19,8 @@ import ccxt
import backtest.loaders.ccxt_loader as cl
from backtest.loaders.base import DEFAULT_MAX_RETRIES
+from backtest.loaders.base import DEFAULT_MAX_RETRIES
+from tests.loader_contract import assert_loader_contract
from backtest.loaders.ccxt_loader import DataLoader
SINCE = int(pd.Timestamp("2026-05-01").timestamp() * 1000)
@@ -79,7 +81,7 @@ def test_happy_path_single_call_unchanged():
df = DataLoader._fetch_one(ex, "BTC/USDT", "1d", SINCE, END)
assert ex.calls == 1 # short page (< limit) -> exactly one call, as before
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
-
+ assert_loader_contract(df, context="ccxt bounded daily")
def test_wallclock_budget_enforced(monkeypatch):
seq = iter([1000.0, 1000.0, 1_000_000.0]) # deadline blown by the retry check
diff --git a/agent/tests/test_eastmoney_loader.py b/agent/tests/test_eastmoney_loader.py
index fafd9db0f..63b75e966 100644
--- a/agent/tests/test_eastmoney_loader.py
+++ b/agent/tests/test_eastmoney_loader.py
@@ -15,6 +15,8 @@ import pandas as pd
import pytest
from backtest.loaders import eastmoney_client
+from backtest.loaders import eastmoney_client
+from tests.loader_contract import assert_loader_contract
from backtest.loaders.eastmoney_loader import DataLoader, _to_compact_date
@@ -98,6 +100,7 @@ class TestFetchWithMockedClient:
df = out["600519.SH"]
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="canonical frame")
assert isinstance(df.index, pd.DatetimeIndex)
assert df.index.is_monotonic_increasing
assert len(df) == 2
diff --git a/agent/tests/test_finnhub_loader.py b/agent/tests/test_finnhub_loader.py
index 154409c59..252e75204 100644
--- a/agent/tests/test_finnhub_loader.py
+++ b/agent/tests/test_finnhub_loader.py
@@ -12,6 +12,8 @@ from typing import Any, Dict, List
import pandas as pd
from backtest.loaders import finnhub_loader
+from backtest.loaders import finnhub_loader
+from tests.loader_contract import assert_loader_contract
from backtest.loaders.finnhub_loader import (
DataLoader,
_to_epoch_seconds,
@@ -125,6 +127,7 @@ class TestFetch:
df = out["AAPL.US"]
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="canonical frame")
assert isinstance(df.index, pd.DatetimeIndex)
assert len(df) == 2
assert df.index.is_monotonic_increasing
diff --git a/agent/tests/test_fmp_loader.py b/agent/tests/test_fmp_loader.py
index 5cf3be1a7..d2d5500c4 100644
--- a/agent/tests/test_fmp_loader.py
+++ b/agent/tests/test_fmp_loader.py
@@ -10,6 +10,8 @@ import pandas as pd
import pytest
from backtest.loaders import fmp_loader as fl
+from backtest.loaders import fmp_loader as fl
+from tests.loader_contract import assert_loader_contract
from backtest.loaders.fmp_loader import DataLoader, _fmp_symbol, _parse_historical
@@ -77,6 +79,7 @@ class TestParseHistorical:
assert list(df.index) == [pd.Timestamp("2024-01-03"), pd.Timestamp("2024-01-04")]
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="canonical frame")
assert df["close"].iloc[0] == 1.5
for col in df.columns:
assert df[col].dtype == float
diff --git a/agent/tests/test_futu_loader.py b/agent/tests/test_futu_loader.py
index deb2576cb..7eb6a1def 100644
--- a/agent/tests/test_futu_loader.py
+++ b/agent/tests/test_futu_loader.py
@@ -41,6 +41,13 @@ from backtest.loaders.futu import ( # noqa: E402
_to_futu_symbol,
_to_futu_ktype,
)
+from backtest.loaders.futu import ( # noqa: E402
+ FutuLoader,
+ _normalize_frame,
+ _to_futu_symbol,
+ _to_futu_ktype,
+)
+from tests.loader_contract import assert_loader_contract
from backtest.loaders.base import NoAvailableSourceError # noqa: E402
# ---------------------------------------------------------------------------
@@ -233,6 +240,7 @@ class TestFetch:
df = result["700.HK"]
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="canonical frame")
def test_futu_symbol_converted_correctly(self, loader, mock_ctx):
mock_ctx.request_history_kline.return_value = (0, _make_kline_df(), None)
diff --git a/agent/tests/test_gildata_loader.py b/agent/tests/test_gildata_loader.py
index e8642411a..3fc0d471e 100644
--- a/agent/tests/test_gildata_loader.py
+++ b/agent/tests/test_gildata_loader.py
@@ -11,6 +11,8 @@ import pandas as pd
import pytest
from backtest.loaders import gildata_loader as gl
+from backtest.loaders import gildata_loader as gl
+from tests.loader_contract import assert_loader_contract
from backtest.loaders.gildata_loader import (
DataLoader,
_gildata_symbol,
@@ -114,6 +116,7 @@ class TestParseDailyRows:
assert list(df.index) == [pd.Timestamp("2024-01-03"), pd.Timestamp("2024-01-04")]
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="canonical frame")
for col in df.columns:
assert df[col].dtype == float
diff --git a/agent/tests/test_india_broker_loader.py b/agent/tests/test_india_broker_loader.py
index e247e4481..dd5a40f5c 100644
--- a/agent/tests/test_india_broker_loader.py
+++ b/agent/tests/test_india_broker_loader.py
@@ -12,6 +12,8 @@ import datetime as dt
import pandas as pd
from backtest.loaders import india_broker_loader as mod
+from backtest.loaders import india_broker_loader as mod
+from tests.loader_contract import assert_loader_contract
from backtest.loaders.india_broker_loader import DataLoader, _base_symbol, _exchange_for
@@ -66,6 +68,7 @@ def test_fetch_parses_and_clips_window(monkeypatch) -> None:
assert len(df) == 2
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="india broker daily")
# Broker received the bare symbol on the right exchange.
assert fake.calls[0]["symbol"] == "RELIANCE"
assert fake.calls[0]["exchange"] == "NSE"
diff --git a/agent/tests/test_local_loader.py b/agent/tests/test_local_loader.py
index 211f3ca61..e3836e67f 100644
--- a/agent/tests/test_local_loader.py
+++ b/agent/tests/test_local_loader.py
@@ -10,6 +10,7 @@ import pytest
import yaml
import backtest.loaders.local_loader as local_loader
+from tests.loader_contract import assert_loader_contract
def _configure(monkeypatch: pytest.MonkeyPatch, tmp_path: Path, sources: list[dict]) -> None:
@@ -59,6 +60,7 @@ def test_local_loader_fetches_csv_with_local_prefix(
)
assert set(frames) == {"AAPL.US"}
+ assert_loader_contract(frames["AAPL.US"], context="local csv daily")
assert list(frames["AAPL.US"]["close"]) == [10.5, 12.5]
diff --git a/agent/tests/test_mootdx_loader.py b/agent/tests/test_mootdx_loader.py
index ff1040f80..19073c830 100644
--- a/agent/tests/test_mootdx_loader.py
+++ b/agent/tests/test_mootdx_loader.py
@@ -9,6 +9,8 @@ import pytest
import backtest.loaders.mootdx_loader as ml
from backtest.loaders.mootdx_loader import DataLoader, _is_a_share, _is_bj
+from backtest.loaders.mootdx_loader import DataLoader, _is_a_share, _is_bj
+from tests.loader_contract import assert_loader_contract
# ---------------------------------------------------------------------------
@@ -110,6 +112,7 @@ def test_fetch_daily_uses_get_k_data(fake_client: _FakeStdQuotes) -> None:
df = out["000001.SZ"]
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="mootdx daily")
assert len(df) == 3
# Symbol stripping: SDK called with bare 6-digit code.
assert any(call[0] == "get_k_data" and call[1] == "000001" for call in fake_client.calls)
diff --git a/agent/tests/test_mt5_loader.py b/agent/tests/test_mt5_loader.py
index caef26527..1abf50e85 100644
--- a/agent/tests/test_mt5_loader.py
+++ b/agent/tests/test_mt5_loader.py
@@ -20,6 +20,7 @@ import pytest
import backtest.loaders.mt5_loader as mt5_loader
from backtest.loaders.mt5_loader import DataLoader, _to_query_base
+from tests.loader_contract import assert_loader_contract
pytestmark = pytest.mark.unit
@@ -173,6 +174,7 @@ class TestIntervalsAndFrames:
loader = DataLoader()
frames = loader.fetch(["EUR/USD"], "2026-06-01", "2026-06-10")
frame = frames["EUR/USD"] # keyed by the ORIGINAL input code
+ assert_loader_contract(frame, context="mt5 daily")
assert list(frame.columns) == ["open", "high", "low", "close", "volume"]
assert frame.index.name == "trade_date"
assert frame["volume"].tolist() == [1200, 1300, 1400] # tick_volume
diff --git a/agent/tests/test_nobitex_loader.py b/agent/tests/test_nobitex_loader.py
index cd0f57158..a8f11091f 100644
--- a/agent/tests/test_nobitex_loader.py
+++ b/agent/tests/test_nobitex_loader.py
@@ -14,6 +14,8 @@ import pytest
import requests
from backtest.loaders import nobitex
+from backtest.loaders import nobitex
+from tests.loader_contract import assert_loader_contract
def _udf_payload(
@@ -128,6 +130,7 @@ class TestFetch:
assert df.index.is_monotonic_increasing
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert len(df) == 2
+ assert_loader_contract(df, context="canonical frame")
assert df["close"].tolist() == [1.5, 2.5]
assert df["volume"].dtype.kind == "f"
assert recorder.calls[0]["params"]["symbol"] == "BTCIRT"
diff --git a/agent/tests/test_pykrx_loader.py b/agent/tests/test_pykrx_loader.py
index 1dd63c752..db1f13129 100644
--- a/agent/tests/test_pykrx_loader.py
+++ b/agent/tests/test_pykrx_loader.py
@@ -21,6 +21,7 @@ import pytest
from backtest.loaders import pykrx_loader as mod
from backtest.loaders.pykrx_loader import DataLoader, _normalize, map_symbol
+from tests.loader_contract import assert_loader_contract
class TestMapSymbol:
@@ -56,6 +57,7 @@ class TestNormalize:
def test_renames_sorts_and_selects_ohlcv(self) -> None:
out = _normalize(_pykrx_frame())
assert out is not None
+ assert_loader_contract(out, context="pykrx normalized")
assert list(out.columns) == ["open", "high", "low", "close", "volume"]
assert out.index.name == "trade_date"
assert out.index.is_monotonic_increasing
diff --git a/agent/tests/test_qveris_loader.py b/agent/tests/test_qveris_loader.py
index 401eef5b4..c2d0b8127 100644
--- a/agent/tests/test_qveris_loader.py
+++ b/agent/tests/test_qveris_loader.py
@@ -13,6 +13,8 @@ import pandas as pd
import pytest
from backtest.loaders import qveris_loader as qv
+from backtest.loaders import qveris_loader as qv
+from tests.loader_contract import assert_loader_contract
from backtest.loaders.base import NoAvailableSourceError
from backtest.loaders.registry import (
FALLBACK_CHAINS,
@@ -245,6 +247,7 @@ class TestFetch:
df = out["BTC-USDT"]
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="canonical frame")
assert isinstance(df.index, pd.DatetimeIndex)
assert df.index.dtype == "datetime64[ns]"
assert df.loc["2024-01-02", "close"] == 110.0
diff --git a/agent/tests/test_sina_loader.py b/agent/tests/test_sina_loader.py
index 9dd865271..e300a6ded 100644
--- a/agent/tests/test_sina_loader.py
+++ b/agent/tests/test_sina_loader.py
@@ -20,6 +20,14 @@ from backtest.loaders.sina_loader import (
_strip_jsonp,
_to_sina_symbol,
)
+from backtest.loaders.sina_loader import (
+ DataLoader,
+ _bars_to_frame,
+ _is_us_equity,
+ _strip_jsonp,
+ _to_sina_symbol,
+)
+from tests.loader_contract import assert_loader_contract
# ---------------------------------------------------------------------------
@@ -99,6 +107,7 @@ def test_bars_to_frame_shape_and_dtypes() -> None:
assert df is not None
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="sina bars_to_frame")
assert isinstance(df.index, pd.DatetimeIndex)
assert all(str(df[c].dtype) == "float64" for c in df.columns)
assert len(df) == 3
diff --git a/agent/tests/test_stooq_loader.py b/agent/tests/test_stooq_loader.py
index 5666a0f05..cf33c4c37 100644
--- a/agent/tests/test_stooq_loader.py
+++ b/agent/tests/test_stooq_loader.py
@@ -18,6 +18,8 @@ import pytest
import requests
from backtest.loaders import stooq_loader
+from backtest.loaders import stooq_loader
+from tests.loader_contract import assert_loader_contract
@pytest.fixture(autouse=True)
@@ -114,6 +116,7 @@ class TestFetch:
assert isinstance(df.index, pd.DatetimeIndex)
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
# Sorted ascending: 01-02 before 01-03.
+ assert_loader_contract(df, context="canonical frame")
assert list(df.index) == [pd.Timestamp("2024-01-02"), pd.Timestamp("2024-01-03")]
assert df.loc[pd.Timestamp("2024-01-02"), "open"] == pytest.approx(187.15)
assert df.loc[pd.Timestamp("2024-01-03"), "close"] == pytest.approx(184.25)
diff --git a/agent/tests/test_tencent_loader.py b/agent/tests/test_tencent_loader.py
index 3231a14ca..b66433dd8 100644
--- a/agent/tests/test_tencent_loader.py
+++ b/agent/tests/test_tencent_loader.py
@@ -9,6 +9,7 @@ import pandas as pd
import pytest
from backtest.loaders import tencent_loader
+from tests.loader_contract import assert_loader_contract
class _FakeResponse:
@@ -100,6 +101,7 @@ def test_hk_equity_maps_to_hk_prefix_and_parses(monkeypatch) -> None:
assert len(urls) == 1
assert "param=hk00700,day," in urls[0]
df = result["00700.HK"]
+ assert_loader_contract(df, context="tencent hk daily")
assert len(df) == 2
# Tencent kline rows are [date, open, close, high, low, volume].
assert df.iloc[0]["open"] == 466.4
diff --git a/agent/tests/test_tickerall_loader.py b/agent/tests/test_tickerall_loader.py
index 7339bbfbf..8812e1d4c 100644
--- a/agent/tests/test_tickerall_loader.py
+++ b/agent/tests/test_tickerall_loader.py
@@ -18,6 +18,8 @@ import pandas as pd
import pytest
from backtest.loaders import tickerall_loader as tl
+from backtest.loaders import tickerall_loader as tl
+from tests.loader_contract import assert_loader_contract
from backtest.loaders.tickerall_loader import (
DataLoader,
IncompleteHistoryError,
@@ -383,6 +385,7 @@ class TestParseCandles:
assert list(df.index) == [pd.Timestamp("2024-01-03"), pd.Timestamp("2024-01-04")]
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="canonical frame")
assert df["close"].iloc[0] == 1.10
for col in df.columns:
assert df[col].dtype == float
diff --git a/agent/tests/test_tiingo_loader.py b/agent/tests/test_tiingo_loader.py
index 4f7fb1b8c..81c32b2c8 100644
--- a/agent/tests/test_tiingo_loader.py
+++ b/agent/tests/test_tiingo_loader.py
@@ -18,6 +18,13 @@ from backtest.loaders.tiingo_loader import (
_rows_to_frame,
_to_tiingo_symbol,
)
+from backtest.loaders.tiingo_loader import (
+ DataLoader,
+ _resolve_key,
+ _rows_to_frame,
+ _to_tiingo_symbol,
+)
+from tests.loader_contract import assert_loader_contract
# ---------------------------------------------------------------------------
@@ -94,6 +101,7 @@ def test_rows_to_frame_shape_and_dtypes() -> None:
assert df is not None
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="tiingo rows_to_frame")
assert isinstance(df.index, pd.DatetimeIndex)
assert df.index.tz is None
assert all(str(df[col].dtype) == "float64" for col in df.columns)
diff --git a/agent/tests/test_tushare_loader.py b/agent/tests/test_tushare_loader.py
index 345192b18..913860746 100644
--- a/agent/tests/test_tushare_loader.py
+++ b/agent/tests/test_tushare_loader.py
@@ -21,6 +21,7 @@ from backtest.loaders.tushare import (
_is_index,
_is_us_equity,
)
+from tests.loader_contract import assert_loader_contract
# ---------------------------------------------------------------------------
@@ -169,7 +170,7 @@ class TestFetchDailyFrameRouting:
loader.api.index_daily.assert_not_called()
loader.api.hk_daily.assert_not_called()
assert result is not None
- assert not result.empty
+ assert_loader_contract(result, context="tushare stock daily")
def test_etf_routes_to_fund_daily(self) -> None:
loader = self._make_loader()
diff --git a/agent/tests/test_yahoo_loader.py b/agent/tests/test_yahoo_loader.py
index b1e99b16e..9a5527f42 100644
--- a/agent/tests/test_yahoo_loader.py
+++ b/agent/tests/test_yahoo_loader.py
@@ -19,6 +19,15 @@ from backtest.loaders.yahoo_loader import (
_rows_to_frame,
_to_yahoo_interval,
)
+from backtest.loaders.yahoo_loader import (
+ DataLoader,
+ _epoch_seconds,
+ _is_intraday_interval,
+ _is_supported,
+ _rows_to_frame,
+ _to_yahoo_interval,
+)
+from tests.loader_contract import assert_loader_contract
def _epoch(date_str: str) -> int:
@@ -200,6 +209,7 @@ class TestRowsToFrame:
df = _rows_to_frame(rows, "2024-01-01", "2024-01-31")
assert list(df.columns) == ["open", "high", "low", "close", "volume"]
assert df.index.name == "trade_date"
+ assert_loader_contract(df, context="canonical frame")
assert isinstance(df.index, pd.DatetimeIndex)
assert df.index.tz is None
assert all(str(df[col].dtype) == "float64" for col in df.columns)
diff --git a/agent/tests/test_yfinance_crypto.py b/agent/tests/test_yfinance_crypto.py
index 42b928f36..b1d0721a4 100644
--- a/agent/tests/test_yfinance_crypto.py
+++ b/agent/tests/test_yfinance_crypto.py
@@ -6,6 +6,7 @@ import pandas as pd
import pytest
from backtest.loaders.yfinance_loader import DataLoader, _to_yfinance_symbol
+from tests.loader_contract import assert_loader_contract
# ---------------------------------------------------------------------------
@@ -98,6 +99,7 @@ def test_fetch_passes_inclusive_end_date_to_yfinance_as_exclusive_end(monkeypatc
result = yfl.DataLoader().fetch(["AAPL.US"], "2025-01-01", "2025-01-03")
assert "AAPL.US" in result
+ assert_loader_contract(result["AAPL.US"], context="yfinance fallback single-symbol")
assert calls == [(["AAPL"], "2025-01-01", "2025-01-04", "1d")]