Hyperliquid engineering guides
Notes from running Hyperliquid nodes and a data pipeline in production. Commands, configs and the numbers we measured, checked against Hyperliquid's own API.
16 guides · last updated 8 Nov 2026
Newest guide
Hyperliquid paper trading: test a bot without risking funds
Your own simulated account with $10,000 and live prices, through the official SDK's base_url. What is simulated, what a box refuses and how it differs from testnet.
Market data
10 guidesWhere each kind of Hyperliquid data lives, what the API keeps and how to get the history.
Hyperliquid HIP-4 outcome markets: how they work and how to get the data
How outcomes settle and are named, what trades on HIP-4, and trades, candles, settled outcomes and outcome traders over REST, SQL and MCP.
Read guide →Hyperliquid historical data: API, S3 archive, SQL and free downloads
What the info API and the S3 archive keep, how to download the archive, a coverage table by data type, and full history over REST, SQL and free Parquet datasets, with Python.
Read guide →Hyperliquid SQL: query every fill, liquidation and transfer
The hl.* tables behind /v1/query and the MCP run_query tool, the limits per plan, and eight tested queries: candles from fills, taker flow, liquidations, funding, transfers and PnL.
Read guide →How to read the Hyperliquid liquidation map, and how it's built
Walls, cascades and running totals, how each liquidation price is computed from our node's snapshot, the 99.4% check against Hyperliquid, the limits, and the API and MCP tool.
Read guide →Hyperliquid liquidation data: history, levels and API
How liquidations show up on fills, what Hyperliquid's API returns per wallet, and Ironflow's liquidations endpoint, liquidation levels and a SQL alternative.
Read guide →Hyperliquid candles and OHLCV data: the 5000 candle limit and older history
candleSnapshot intervals and the 5000 candle limit, how far back each interval reaches, building candles from fills, Ironflow's candles endpoint and a pandas backtest.
Read guide →Hyperliquid stock perps (HIP-3): markets, trading hours and data API
Which HIP-3 dexes are live, the xyz:NVDA naming, the dex field in the info API, weekend trading and the oracle, and trades, candles and oracle prices over REST and SQL.
Read guide →Hyperliquid funding rates: formula, history and API
Hourly funding, the formula and the 4% per hour cap, fundingHistory, predictedFundings and userFunding, Ironflow's funding endpoints and two Python scripts.
Read guide →Hyperliquid order book data: L2, L4 and history
The live l2Book feeds, what L4 means, the L2 snapshots in Hyperliquid's archive and rebuilding a book from a node's raw diffs.
Read guide →Hyperliquid trades and fills data: API, archive and history by wallet
Fills vs trades, every fill field, the userFills, userFillsByTime and recentTrades limits, TWAP slices, the S3 fills archive, node output and tick data over REST.
Read guide →API
2 guidesLimits and connection behaviour of Hyperliquid's info API and WebSocket.
Hyperliquid API rate limits explained
The 1200 weight per minute IP limit, request weights, address-based limits, WebSocket caps, how to handle 429 and what a node changes.
Read guide →Hyperliquid WebSocket API: subscriptions, limits and a Python example
Mainnet and testnet URLs, the subscribe message, all 24 subscription types, isSnapshot, post requests, ping, reconnects, the per-IP limits and a working Python example.
Read guide →Bots
1 guideTest a Hyperliquid bot with simulated funds and live prices.
Nodes
3 guidesRunning a non-validator node: install, sync, disk and the errors we hit.
Fix: Hyperliquid node crash, missing node_metadata.json
hl-node panics after the 25 Oct 2026 hardfork because of an old hl-visor. How to confirm it, update and verify the visor, and recover without a resync.
Read guide →How to run a Hyperliquid non-validator node
Hardware, install, gossip peers, write flags, first sync, disk cleanup, monitoring and gaps. With the common hl-visor errors and their fixes.
Read guide →Hyperliquid node disk filling up: prune EVM checkpoints
Since the October 2026 hardfork a node keeps a 3 GB EVM checkpoint every 10000 blocks. What is safe to delete and an hourly pruning script.
Read guide →Trades, candles, liquidations, funding and wallet analytics over REST, SQL and MCP. No key needed for the last 24 hours.
A Hyperliquid non-validator node on its own server, run and monitored by us.