pyperliquidity 0.1.0

Off-chain HIP-2 Hyperliquidity market maker for Hyperliquid spot markets

pyperliquidity

A Python implementation of HIP-2 "Hyperliquidity" market-making algorithm. While HIP-2's logic runs fully on-chain, certain spot markets (especially bridged assets) are unable to use this feature. pyperliquidity recovers HIP-2 behavior using an off-chain market maker.

Core concept: Uniswap V2 / infinite-range liquidity pools, but on an order book.

Installation

pip install -e ".[dev]"

Usage

pyperliquidity run --config config.toml

Architecture

WebSocket Feeds ──► StateManager ──► QuotingEngine ──► OrderDiffer ──► BatchEmitter ──► API
     ▲                (single source      (pure math,     (dead zone +     (budget-aware,   │
     │                 of truth)           no I/O)         level-index      prioritized)     │
     └──────────── orderUpdates / userFills / webData2 ──────────────────────────────────────┘

Configuration

See config.example.toml for all available parameters.

Development

This project uses OpenSpec for spec-driven development. Domain specs live in openspec/specs/. Read them before implementing.

pytest                # Run tests
mypy src/             # Type check
ruff check src/       # Lint

License

MIT