API reference

Every public surface, indexed. Four gRPC proto packages on stream.hyperliquidrpc.com:443, plus three HTTPS surfaces. All of them authenticate with the same x-api-key; see Authentication. Message-level schemas come from the protos themselves: reflection is enabled and the .proto files are provided (SDKs & protos).

gRPC packages

hyperliquid (QuickNode-compatible)

The broadest package: the multiplexed StreamData feed plus dedicated book and block services. Wire-compatible with QuickNode's Hyperliquid streams, so existing stubs work unchanged.

MethodTypeCarriesDocs
Streaming/StreamDataserver-streamingOne subscription, six surfaces by stream_type: TRADES, ORDERS, BOOK_UPDATES, TWAP, EVENTS, BLOCKS.Choosing a stream
OrderBookStreaming/StreamL2Bookserver-streamingAggregated book by price level, 1–100 levels, never crossed. Snapshot, then one update per block.L2 order book
OrderBookStreaming/StreamL4Bookserver-streamingFull order-by-order book with owners. Complete snapshot, then per-block diffs.L4 order book
BlockStreaming/StreamBlocksserver-streamingRaw L1 blocks as produced; replay from any height.Blocks

hyperliquid_swaps.v1

The recommended trades surface: every executed fill as a flat swap record (Solana-swap-compatible schema) with wallet attribution, realized PnL, fees, and maker/taker role.

MethodTypeCarriesDocs
SwapStreaming/StreamSwapsserver-streamingExecuted fills, filtered server-side by coins, wallets, and market_type.Trades & swaps

hyperliquid_btc_price.v1

MethodTypeCarriesDocs
BtcPriceStreaming/StreamBtcPricesserver-streamingBTC last-trade price ticker. Minimal payload, available on every tier.BTC price ticker

hyperliquid_l1_gateway.v2 (Dwellir-compatible)

Identical wire semantics to Dwellir's gateway, so stubs generated for Dwellir work unchanged against our endpoint.

MethodTypeCarriesDocs
HyperliquidL1Gateway/StreamBlocksserver-streamingL1 blocks, Dwellir wire format.From Dwellir
HyperliquidL1Gateway/StreamFillsserver-streamingExecuted fills, Dwellir wire format.From Dwellir
HyperliquidL1Gateway/StreamOrderbookSnapshotsserver-streamingOrder-book snapshots, Dwellir wire format.From Dwellir
HyperliquidL1Gateway/GetBlockunaryPoint-in-time block fetch by height.From Dwellir
HyperliquidL1Gateway/GetFillsunaryPoint-in-time fills fetch.From Dwellir
HyperliquidL1Gateway/GetOrderBookSnapshotunaryPoint-in-time book snapshot.From Dwellir

HTTPS surfaces

SurfaceEndpointCoverageReference
HyperEVM JSON-RPChttps://rpc.hyperliquidrpc.com16 methods: reads, eth_getLogs, eth_sendRawTransaction, with example request/response each.HyperEVM JSON-RPC
HyperCore /infohttps://api.hyperliquidrpc.com/info10 request types: market metadata, books, user state, fills, funding.HyperCore /info
Historical query APIhttps://data.hyperliquidrpc.comSQL-style queries over the full archive; results as JSON/CSV. Bulk exports and schemas documented alongside.Query API

A scope note worth repeating: HyperCore CLOB orders (place/cancel) are submitted via Hyperliquid's signed-action exchange API, not our RPC. The EVM RPC reads HyperEVM state and broadcasts HyperEVM transactions.

Field-level schemas

Per-stream message fields, semantics, and sample payloads live on the stream pages (trades, L2, L4, …); archive table schemas on historical schemas. The protos remain the source of truth; when in doubt, grpcurl describe the service.