SnipeLLM Architecture & Manual
The definitive guide to SnipeLLM's institutional architecture—combining real-time Dual-LLM consensus with non-custodial session key delegation on Hyperliquid's Tendermint L1.
1. Executive System Overview
Traditional crypto trading bots rely on static rule sets (grid trading, MACD crossovers, trailing stops) that fail during structural market regime shifts. Conversely, standard single-prompt LLM agents frequently suffer from non-deterministic hallucinations, leading to excessive slippage or unvalidated risk parameters.
SnipeLLM decouples alpha generation from risk verification. The planner proposes, Python risk gates constrain, and GPT-4o must AGREE on the same action. Orders go to Hyperliquid through an EIP-712 agent you approve in Privy — SnipeLLM cannot withdraw.
2. Dual-LLM Consensus Engine
Dual-LLM is a planner + auditor overlay on top of Python risk gates — not two models that cryptographically co-sign.
Planner: Claude Haiku
Reads the live Hyperliquid snapshot and persona profile, then returns JSON: LONG, SHORT, CLOSE, or DO NOTHING. If the planner already says DO NOTHING, the auditor is skipped.
Python risk gates
Leverage (Aegis 3x / Equinox 7x / Vortex 15x), notional caps, daily loss, cooldowns, and market-noise filters run in FastAPI. They are not optional.
Auditor: GPT-4o
Returns AGREE or VETO. AGREE only counts if the auditor action matches the planner. Timeout, 429, or invalid JSON → DO NOTHING.
3. EIP-712 Non-Custodial Session Delegation
Security is the backbone of SnipeLLM. Unlike legacy bots that require dangerous API keys with withdrawal rights or full private key uploads, SnipeLLM utilizes native EIP-712 Typed Data Signing.
- Scoped Order-Only Authorization (Cannot Withdraw Funds)
- Time-Bound Key Expiration (Auto-terminates after session)
- 1-Click Instant On-Chain Revocation
4. Hyperliquid L1 Order Routing
The terminal streams Hyperliquid L2 and mids over WebSocket. Chart history uses the engine GET /api/v1/market/history endpoint (public candle snapshot as fallback before login).
5. Risk Personas
Aegis (conservative, 3x), Equinox (moderate, 7x), Vortex (aggressive, 15x). Copilot can change allocation only after a LIVE subscription.
DEMO: Dual-LLM preview on BTC/ETH/SOL, 8 previews per day. LIVE: USDC subscription + registered agent.