Data ingest

Every data source NVTrader can pull from, with adapter status and what each one feeds. Adapters are pluggable — same Bar/NewsItem/Filing schema across providers — so a sleeve config can switch from yfinance to Polygon without code changes.

Sources

Picking a provider

Each sleeve config (configs/sleeves/*.yaml) names a primary data provider for bars and a fallback. The default is yfinance + Alpaca data as fallback. The default for fundamentals is Finnhub; news = Finnhub + Tavily; filings = EDGAR.

To switch a sleeve to Polygon for bars:

data:
  bars:
    primary: polygon
    fallback: yfinance
  fundamentals:
    primary: finnhub
  filings:
    primary: edgar

Reading the ingest page

The Data page (/data.html) shows for each linked provider:

• Last successful pull — UTC timestamp.
• Rate-limit headroom — calls remaining in the current window if the provider exposes it.
• Latency p50/p95 — measured over the last 100 calls.
• Error rate — last 24h.
• Per-endpoint roll-up — for the providers with multiple endpoints (Finnhub fundamentals vs news vs consensus).

Adding a provider

Subclass traderspace.data.base.DataAdapter. Implement bars(symbol, start, end, interval), plus whichever of fundamentals · news · filings apply. Register via src/traderspace/data/__init__.py. Write a setup playbook at skills/setup/data/<id>.md. Done — the Setup Wizard and the sleeve config layer pick it up automatically.

REST surface