Lookup Trader

Lookup Trader is a local bar-replay and manual trade-labelling tool for building a pattern-based probability database. You ingest HistData candles, replay them with a cursor-gated chart, mark setups, and let a triple-barrier labeler score outcomes into DuckDB.

The hosted read-only Live signals dashboard is at lookup.nishimweprince.dev (research shadow — no order path).

Capital.com is used only for post-HistData XAUUSD H1 bid candles on Demo credentials. The application has no order, position, confirmation, or working-order operation. Meta shadow supervision asserts orders_enabled is False on every artifact load — there is no execution path in the codebase.

What it does

Ingest — HistData minute/tick CSV → Hive-partitioned Parquet under data/candles/.
Replay & label — step through bars; mark entry/stop/target; the backend scores with triple-barrier; compare win rates against stored occurrences.
Feature store — one row per closed candle (context, forward outcome, chart shape, pattern tags) for /base-rate and the chart.
Shadow models — train unpromoted outcome candidates; run a Capital Demo forward shadow worker; optionally supervise meta-shadow alerts (still no orders).

Architecture at a glance


HistData CSV ──▶ scripts/ingest ──▶ data/candles/*.parquet
                                           │
./scripts/dev.sh ──▶ FastAPI + DuckDB ◀────┘
         │                │
         │         build_bar_features ──▶ data/features/
         │                │
         └─▶ React + Vite client (localhost:5173 → /api)

Explore the docs

Ingest → bootstrap → feature store → ./scripts/dev.sh.

Getting Started

Formats, XAUUSD H1 contract, partitions, recovery, and the sample fixture.

HistData Ingestion

Session, replay, mark, compare — blinded mode and triple-barrier scoring.

Labelling Workflow

server/, client/, data/, and scripts/ layout.

Architecture

build_bar_features, version bumps, taggers, /base-rate, confidence vs probability.

Bar Features & Pattern Tagging

Export training matrix, train candidates, promoted=false, frozen holdout.

Outcome Model

sync_capital and the no-order Demo shadow worker.

Capital Forward Shadow

Worker, retrain, calendar, watchdog — orders_enabled False.

Meta Shadow Ops

Symbols, candles, sessions, trades, compare, shadow, and health.

API Reference

LOOKUP_* and VITE_COMPARE_* env vars and sample thresholds.

Configuration

pytest and the acceptance checklist.

Tests & Acceptance

Out of scope

LLM/Claude tagging and model distillation are retired — pattern identity stays deterministic and rebuildable. Trading, WebSockets, native Capital H4, production authentication, and multi-user operation remain out of scope.