userFillsDocs →
Trading fills for up to 1,000 wallets per subscription. Includes TWAP fills, closed PnL, and transaction hash on every fill.
addressescoinpxszsideclosedPnlhashoid
WebSocket API · Real-time · Hyperliquid
Hyperliquid websockets
Trades, orders, builder fills, liquidations, deposits, leverage updates. We cover every event happening on Hyperliquid.
~70ms per-block updatesValidator infrastructure
TL;DR
The most complete websocket API on Hyperliquid. We cover the boring basics, ship the best streams for app builders, and run unique firehoses that no one else exposes. Plus advanced session recovery and live message chunking so you don't lose events at scale. Trusted by 80+ teams on Hyperliquid.
Real-time Hyperliquid market data for the teams that need it
BasedKinetiqMasstread.fiVentualsLiquidBullpenSEDADexariSenpiGlobal ComputeAura+65 others
§ What you get
A Hyperliquid websocket that covers everything
The native Hyperliquid websocket gives you the basics. Hydromancer gives you the basics — done right — plus three things you can't get anywhere else: builder-scoped streams, full-network firehoses, and the production-grade session recovery you need once your app stops being a prototype.
Looking for orderbook streaming specifically? Read the Hyperliquid orderbook streaming page.
wss://api.hydromancer.xyz/ws~70ms
→ subscribe userFills · addresses[1,247]
→ subscribe builderLiquidations · 0x742...f2e2
← { ok: true, sessionId: "s_8f3a..." }
~ userFills BTC-PERP $97,421 +2.5
~ builderLiquidations SOL-PERP $127K
~ userOrderUpdates ETH-PERP filled
~ userFills HYPE-PERP $21.27 +130
~ ping 8ms_
§ 01 — Boring basics
We cover the boring basics — without the limits
Per-wallet streams done properly. No rate limits choking you when you scale, no per-user connection caps. Each subscription supports up to 1,000 addresses.
userOrderUpdatesDocs →
Order lifecycle events — open, fill, cancel — for up to 1,000 wallets per subscription. Powers portfolio dashboards and live position tracking.
addressestimeuserhashstatusorder
§ 02 — Builder streams
The best Hyperliquid streams for app builders
One subscription per builder address gives you every fill, every order update, and every liquidation routed through your app. Powers many trading apps monetizing through builder codes.
builderFillsDocs →
Every fill routed through your builder address. The foundation of builder-revenue accounting and per-app trading analytics.
buildercoinpxszfeeclosedPnltxIndex
builderLiquidationsDocs →
Liquidation fills for users routed through your builder. liquidatedUser, markPx, and full fill detail per event.
builderdexaggregateByTimeliquidatedUsermarkPxtxIndex
builderOrderUpdatesDocs →
Order status notifications for every order placed through your builder. Watch open, fill, partial fill, and cancel events across all of your users in one stream.
buildertimeuserhashstatusorder.coinorder.sideorder.limitPxorder.szorder.oid
§ 03 — Firehoses
Unique firehoses covering all events of a type
Not part of the native Hyperliquid API. Stream every fill, every leverage update, and every ledger event across the entire network — no address list, no filtering. The only way to get this data in real time.
allFillsDocs →
Hydromancer-onlyAdd-on
Every trade on Hyperliquid, live. Filter by coin, dex, or outcome markets. Powers market-data terminals, oracles, and quant pipelines.
coinpxszsideclosedPnltxIndex
allLeverageUpdatesDocs →
Hydromancer-only
Every leverage change network-wide. Leverage adjustments, isolated-margin updates, top-up isolated margin — all batched per block.
seqcursorupdates
allUserNonFundingLedgerEventsDocs →
Hydromancer-only
Every transfer, deposit, and withdrawal. Set addStakingEvents: true to also receive delegation, cDeposit, and cWithdrawal events.
dexaddStakingEventsevents[]delta
§ Reliability
We've thought about every edge case
Production websockets fail in interesting ways — disconnects, network blips, message size limits, replays that overlap with live data. We've built around all of it so you don't have to.
01 · Session recovery
Persistent sessions with cursor replay
Every connection gets a sessionId that survives reconnects. Pass your last cursor and the server replays missed events automatically (up to 30s buffer).
Gap detection via seq numbers. Replay/live overlap deduped on (time, txIndex). hasGap: true signals when REST backfill is needed.
02 · Live message chunking
Big batches without dropped connections
Enable liveFormat=chunked-v1 and large batches split into chunks of 1,000 items by default — eliminating disconnects during high-volume bursts. No data loss.
Each chunk carries chunk, totalChunks, and batchId for ordered reassembly. Backward-compatible with existing clients.
03 · REST backfills
When the 30s replay window isn't enough
For longer outages or historical replay, the same data is available through our REST endpoints. Same schemas, same fields, same wallet identifiers — just a different transport.
userFillsByTime, builderFillsByTime, userNonFundingLedgerUpdates, and the rest of our historical surface.
§ Built for
The Hyperliquid websocket feed your product actually needs
Trading terminals
Live trades, fills, and order updates with no rate-limit ceiling and 1,000-address subscriptions per channel.
Market makers
Order ID lookup, full leverage-change firehose, and per-block delivery for systematic strategies.
App builders
Builder-scoped fills, orders, and liquidations in one stream. Revenue accounting and per-user analytics become trivial.
Analytics & explorers
Network-wide allFills firehose — perfect for ingesting large amounts of data to run analysis on later.
Copytrading platforms
Watch thousands of wallets simultaneously, route their fills downstream, never fall off the socket.
Quant research
Run the quant strategies in prod after backtesting them using our historical archive.
§ One stack
Streaming that composes with the rest of the stack
80+ apps and trading firms use Hydromancer for their Hyperliquid data ops. One API key covers real-time data streams, orderbook streaming (L2 + L4), the Reservoir historical archive, HIP-4 prediction markets, and the HIP-3 stack.