Hyperliquid gRPC Streaming
Raw L1 Feeds, Typed Market Streams
Stream blocks, fills, order statuses, and book diffs straight from Hyperliquid nodes. Replay from any retained block or timestamp, filter by user or coin, and open 14 typed market streams over Protocol Buffers.
Raw Feeds vs Market Streams
Node Feeds with Replay
Six feeds read from the files the Hyperliquid node writes to disk, plus generated order-book snapshots. Each record arrives in a shared envelope with block number and timestamp cursors when present.
- Blocks, fills, order statuses, raw book diffs, misc events, TWAP statuses
- Inclusive replay from a block number or Unix-ms timestamp, then live tail. Order-book snapshots take a timestamp cursor only.
- Server-side filters on users and coins for fills, diffs, and statuses
- Unary lookups return one record per call
{"blockNumber": "1139998345", "events": [["0x15b3...", {"coin": "BTC", "px": "78631.0"}]]}Typed Live Streams
Fourteen streams with typed request and response messages. Stateful views open with a snapshot or current state, then send ordered updates. Trade and fill streams are live-only.
- L2 book up to 100 levels per side, BBO for up to 20 coins per subscription
- L4 book, typed order updates, and take-profit/stop-loss lifecycle
- Trades, all/user/builder/liquidation fills, candles from 1s to 1d
- Sequence numbers on incremental streams for gap detection
{"coin": "BTC", "blockNumber": "1140007989", "bids": [{"px": "78497", "sz": "2.59056", "n": 16}]}Connect in Three Steps
Download the contract
Fetch the published proto. It defines both services, every message, and the filter contract.
curl -fsSLo v3.proto https://www.dwellir.com/docs/hyperliquid/grpc/v3.proto
Generate client stubs
Generate from the exact proto version you call. Runnable Go, Python, and Node.js examples are on GitHub.
protoc --go_out=. --go_opt=Mv3.proto=./hlgateway \ --go-grpc_out=. --go-grpc_opt=Mv3.proto=./hlgateway v3.proto
Connect over TLS with your API key
Pass the key in the x-api-key metadata header on every RPC. Start with ListFeeds to see what the endpoint serves.
grpcurl -proto v3.proto \ -H "x-api-key: $DWELLIR_API_KEY" \ "$HYPERLIQUID_GRPC_ENDPOINT" \ hyperliquid_l1_gateway.v3.HyperliquidL1Gateway/ListFeeds
Every Feed and Stream
Raw feeds HyperliquidL1Gateway
Market streams MarketStreaming
Built for Resumable Consumers
Replay and Resume
Position any raw feed at a block number or timestamp. The endpoint replays the selected record and every retained record after it, then tails live data. Order-book snapshots position by timestamp only.
Server-side Filters
Filter fills, raw book diffs, order statuses, and TWAP statuses by users and coins before they leave the endpoint. AND across fields, OR within a field.
Published Contracts
The proto file is public. Connect over TLS with the x-api-key metadata header from any language with a gRPC toolchain.
Documented to the Action
Block payloads are decoded in the docs down to all 47 signed action types, from order and cancel to twapOrder, vaultTransfer, and evmRawTx.
Pricing Plans
gRPC Streaming API
- -Seven raw node feeds with replay
- -Fourteen typed market streams
- -Server-side filters by user and coin
- -Public proto contract, typed messages
- -Metered: 1 request = 1 credit
Dedicated Cluster
- -Unlimited RPS - no rate limits
- -Flat monthly rate - no usage charges
- -gRPC + Order Book Server included
- -Dedicated HyperEVM JSON-RPC cluster (2+ nodes)
- -Info endpoints included
- -Extended SLAs available
Replay history varies by feed and endpoint. For data outside retention, see historical data. Full comparison on the Hyperliquid pricing page.
Order Book WebSocket API
Prefer JSON over WebSocket? The Order Book Server mirrors the public Hyperliquid channels with deeper books and faster delivery from Singapore and Tokyo.
- L2 depth up to 100 levels per side (vs 20 on the public API)
- L4 individual orders with user addresses and order IDs
- BBO and trades channels, optional user filter
- Median latency 24% faster than the public endpoint
Ready to Stream Hyperliquid L1?
Download the proto, generate stubs, and connect in minutes.
Questions? Our team is here to help.
What our customers say
Jarmo Isotalo
CTO, Token Terminal
"We are very impressed! You are fast at deploying new nodes and we haven't experienced any downtime yet with Dwellir."
Wesley Charles Blake
DevOps Lead, Chronicle
"Chronicle Labs utilizes Dwellir as a key component of our decentralized RPC strategy. Their team has consistently impressed us with their responsiveness and commitment to service. We've found their pricing to be very fair, and their service response is excellent."
Anıl Küçükrecep
Senior Engineering Manager, Paribu
"Dwellir is more than just a service provider for Paribu Custody; they are a strategic partner. They consistently deliver tailored solutions, always standing by our side. Their reliability, speed, and proactive approach ensure seamless operations. Working with them truly makes a difference."
Ingo Rübe
Founder, KILT Protocol
"Dwellir has been a trusted and reliable partner since the early days. In addition to running a collator for KILT – contributing to the efficient functioning of the blockchain – Dwellir also runs RPC nodes enabling external parties to connect to the chain."
ar1ur3
Trady.xyz
"We process billions of onchain data responses through Dwellir every month, and the infrastructure keeps up with that sustained load. When we need help, we get fast, personal support from people who understand our setup and work with us directly."
Karel Balogh
Product Manager, SQD
"Dwellir has significantly simplified our complex multi-chain coverage, enabling us to focus on our product instead of infrastructure management. Their team is always responsive and ready to help, making the experience even better."
Rene Stefancic
Chief Operating Officer, Enjin
"Dwellir relieved our DevOps team. Their tailored infrastructure solutions helped us push past our usual stress points, so we could put our energy back into our core products."
Dillon Hanson
Head of Business Development, DIA
"DIA leverages Dwellir's robust infrastructure as a primary and/or backup RPC provider to power oracle services across a wide range of blockchain networks. Their reliability and forward-thinking approach to supporting new and emerging ecosystems align closely with DIA's mission to provide resilient, scalable data infrastructure for Web3. This collaboration enhances DIA's redundancy model and strengthens DIA's ability to serve as a foundational layer for decentralized applications across the multi-chain landscape."
Norbert Veelenturf
Product Manager, Bitvavo
"We've been very happy so far with the services, currently using Dwellir mainly for our Polkadot ecosystem chains where we're very happy with the uptime, low latencies and the fast customer support."
Harald Heckmann
Head of Blockchain Engineering, Zeitgeist
"We can count on Dwellir in any situation. They are very reliable and skilled"
Get your API key
and join other leading Web3 companies using Dwellir's infrastructure