Hyperliquid

What is Hyperliquid?

Hyperliquid is an on-chain perpetual-derivatives exchange that runs on its own Layer-1 specialized for order books. The order-book matching mechanism is fully on-chain — including cancel/replace, but with low latency thanks to the specialized chain.

Founded in 2023. Its biggest distinguishing feature: the combination of CEX-like performance (sub-second orders) and DEX transparency (every order verifiable on-chain).

Relevant for Botty

• Settlement currency: USDC (transferable internally spot → perp)
• Leverage: up to 50x on BTC/ETH, sometimes lower on alts
• Order types: market, limit (GTC/IOC/ALO), stop-market, stop-limit, TP/SL grouped
• API wallet system: a separate wallet address with restricted rights that may only execute trading (no withdrawals) — this makes the bot wallets' private keys low-risk, even if compromised. Botty has 3 API wallets (one per strategy).
• Testnet: fully functional, identical API. USE_TESTNET=true in .env.

API quirks

• Grouped orders (grouping="normalTpsl") allow the atomic placement of entry + stop — Botty uses this to never be open without a stop.
• Price units: limit_px is expected as an integer price — a classic pitfall.
• Reduce-only flag: mandatory for stop-loss orders, otherwise they are interpreted as a new position.
• WebSocket: live fills, position updates, funding events.

Fees & funding

• Maker/taker fees: ~0.02 % / 0.05 % (as of 2026).
• Funding: hourly, floating rate.

Documentation

infra/hyperliquid.py wraps the API calls. infra/transfer.py for USDC spot↔perp.