NexusScalp Engine
Trading cuantitativo impulsado por investigación. Hecho para la evidencia. Diseñado para el control.
Una plataforma de scalping basada en investigación, hexagonal y dirigida por eventos para MetaTrader 5 — características causales, modelos profundos gobernados, un motor de riesgo invariante, herramientas de investigación deterministas y observabilidad forense en un pipeline auditable.
pip install -e ".[dev]"
nexus doctor && nexus startAnimated visualization of the Nexus engine core: a geometric AI core surrounded by market data panels, candlestick structures, risk shield and telemetry — decorative.
Nuevo en main
SIN PUBLICAR⚙️ Una línea auditable
System map →From tick to ledger, every stage is isolated behind hexagonal ports. Promotion between stages requires an operator decision on reproducible evidence.
✦ Por qué Nexus
Not a claim of alpha — a way of treating claims. Evidence grades every capability; candidates never promote themselves.
Evidence before claims
Metrics without evidence render n/a. Negative results are published — the 70D candidate was rejected by our own OOS gate.
Explorar →Causal feature engineering
Strictly causal 50D contract (INV-008) with deterministic fallbacks — identical for live, replay and training, pinned by schema hash.
Explorar →Deterministic research
Purged + embargoed walk-forward, bit-exact replay, fingerprinted datasets, models and runs with full provenance.
Explorar →Invariant risk engine
Hard clamps live in the execution path: Kelly sizing, margin ≤20%, HARD_MAX_LOTS, kill switch — not in a comment.
Explorar →Runtime truth
Broker facts and runtime gates outrank intent and stale caches. Gates are authorities; settings are intent.
Explorar →Forensic observability
Severity-split logs, incident correlation, deploy gate and the published bug ledger — every failure leaves evidence.
Explorar →▦ Tres modos — riesgo por construcción
The safety model is architectural: PAPER is the default, SHADOW can never place orders, LIVE needs explicit operator confirmation.
🟢 PAPER — Entorno seguro
Fully simulated market and orders. For first run, development and UI work — no broker connection at all.
Docs →👁 SHADOW — Feed en vivo · cero autoridad de órdenes
Evaluate signals, gates and the full pipeline on real market data — while research, shadow and learning components physically cannot place orders.
Docs →🔴 LIVE — Autoridad real de órdenes
Broker IPC / ZMQ with an account-identity fail-safe. LIVE requires explicit operator confirmation and inherits every risk clamp.
Docs →🔬 Un laboratorio de investigación, no una caja negra
Matriz completa →Historical data becomes falsifiable evidence through a fixed chain. Each capability carries an evidence grade — and rejections stay published.
- DATASET
- FEATURE CONTRACT
- MODEL
- EXPERIMENT
- WALK-FORWARD
- OOS GATE
- REPLAY
- VALIDATION
- PROMOTION
| Capacidad | Estado |
|---|---|
| 50D live contract (scalp_v1) | CERTIFIED |
| Walk-forward + hard OOS gate | CERTIFIED |
| Artifact-first Model Factory | IMPLEMENTED |
| 70D contract (Base+News+Liquidity) | EXPERIMENTAL |
| 70D OOS evidence (real data) | NOT_ELIGIBLE |
| Counterfactual engine (NO_TRADE walk) | RESEARCH |
The 70D candidate (Base+News+Liquidity) is research, not production: the hard OOS gate returned NOT_ELIGIBLE on real-data walk-forward. The live contract stays 50D until a candidate clears every gate and an operator promotes it.
📈 XAUUSD M1 — how Nexus reads the market
Order Blocks, Fair Value Gaps, liquidity sweeps and the entry-SL-TP envelope are first-class domain concepts enforced by the SMC policy matrix.
Deterministic demonstration data — illustrative only, never live broker data. Hover or focus the chart to inspect each zone.
An illustrative XAUUSD candlestick chart showing order block, fair value gap, liquidity sweep, entry, stop loss and take profit zones generated from deterministic demo data.
🗺️ Arquitectura hexagonal
Arquitectura →The domain is frozen at the center; everything else — broker, database, web, research — is a swappable adapter behind ports. Click a layer for its documentation.
🖥️ El centro de mando
A real operator console — live monitoring, strategy research, model governance, news intelligence and the forensic incident center. Screenshot from the shipped Web UI.
📊 Pulso del proyecto
Estado del proyecto →Generated at build time from repository truth and refreshed from GitHub's public API — no hard-coded numbers, N/A until proven.
⚡ Novedades — v9.0.17
2026-10-17- e171c792 chore(release): bump version to 9.0.17 for end-user fixes (#666)
- cd847b7c fix(web): hand the auth token to the Go child on the packaged boot path (#665)
- 7a4ba910 fix(release): quote the post-release verifier heredoc so it stops mangling itself (#664)
- Windows x64: SUPPORTED (PyTorch/Polars/MetaTrader5 wheels exist)
- Windows ARM64: UNSUPPORTED — no wheels for the dependency stack
📚 Explora la documentación
Inicio
Instala, ejecuta y configura el motor. PAPER es el modo por defecto; SHADOW da datos en vivo sin autoridad de órdenes.
Proyecto
Qué es Nexus, qué está certificado vs experimental y hacia dónde va — todo graduado por evidencia.
Arquitectura
Cómo está construido el motor: capas hexagonales, el camino del tick a la decisión, gobernanza de modelos y el bucle de inteligencia.
Investigación
Cómo los datos históricos se convierten en evidencia falsable — datasets, backtests, walk-forward, OOS, replay, contrafactuales.
Ingeniería
Puertas de calidad, arquitectura de CI, proceso de release y postura de seguridad.
Guías
Operar el motor día a día: CLI, API REST, solución de problemas, flujos comunes.
Contribuir
El contrato de ingeniería, la propiedad de la documentación y cómo añadir un idioma.
Referencia
Referencia CLI, glosario, terminología y respuestas honestas en las FAQ.
🗓️ Cronología de versiones
Todas las versiones →¿Listo para evaluar con datos reales — sin riesgo?
Empieza en SHADOW. Mismas funciones, mismas puertas, misma línea — cero autoridad de órdenes.