ZERO Engine

Autonomous trading intelligence engine. 9 evaluation layers. 40+ markets. 97% rejection rate.

What Is ZERO

ZERO is a multi-layer trading intelligence system that evaluates markets through independent analysis layers, requires consensus before action, and maintains strict risk controls. It rejects 97% of setups — the 3% that pass become trades.

Architecture

┌──────────────────────────────────────────────┐
│                  ZERO Engine                  │
├──────────────┬──────────────┬────────────────┤
│   9 Layers   │   Consensus  │   Execution    │
│              │              │                │
│ Technical    │ Multi-layer  │ Risk gate      │
│ Regime       │ agreement    │ Position mgmt  │
│ Funding      │ required     │ Stop protection│
│ Liquidity    │ before any   │ Immune system  │
│ Correlation  │ trade fires  │ Dead man switch│
│ Sentiment    │              │                │
│ Timeframe    │              │                │
│ LLM          │              │                │
│ Adversary    │              │                │
└──────────────┴──────────────┴────────────────┘

Quick Start

# Clone
git clone https://github.com/squaeragent/zero-engine.git
cd zero-engine

# Setup
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

# Configure
cp .env.example .env
# Edit .env with your API keys

# Run
python -m scanner.v6.supervisor --split --loop

Configuration

Copy .env.example to .env and set:

Variable	Required	Description
HYPERLIQUID_SECRET_KEY	Yes	Hyperliquid trading key
HL_MAIN_ADDRESS	Yes	Your wallet address
TELEGRAM_BOT_TOKEN	No	Alerts via Telegram
OPENROUTER_API_KEY	No	LLM evaluation layer

MCP Server

ZERO exposes 33 tools via Model Context Protocol:

python -m scanner.v6.mcp_server --http

Connect any MCP-compatible AI agent to monitor, control, and query the engine.

API

# Start API server
python -m uvicorn scanner.v6.server:app --host 0.0.0.0 --port 8420

# Endpoints
GET /health          # Engine health + component status
GET /heat            # Market heat map
GET /score           # Current conviction score
GET /positions       # Open positions
GET /risk            # Risk metrics + drawdown
GET /signals         # Latest signals
WS  /ws              # Real-time data stream

Safety

• Immune System: Independent position protection that verifies stops every 60s
• Dead Man's Switch: Auto-tightens stops if controller goes unresponsive
• Circuit Breakers: Daily loss limits, drawdown limits, order rate limits
• Risk Gate: Every trade passes through independent risk verification
• Paper Mode: Full simulation without real capital

Tests

python -m pytest scanner/tests/ -q
# 2000+ tests, ~130s

License

Apache License 2.0 — see LICENSE.

Links

• Website: getzero.dev
• Docs: getzero.dev/docs
• Discord: Join