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 WebSocket API
Stream trades, fills, orders, builder events, and liquidations as they happen. One subscription covers up to 1,000 wallets, and a reconnect replays missed events from your last cursor, up to 15 minutes back on most channels.
{"method":"subscribe","subscription":{"type":"userFills","addresses":["0x..."]}}~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 100+ 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 15 minutes on most channels, 5 for order updates and 3 for L4 book updates.
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 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
100+ 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.