Hyperliquid RPC
Hyperliquid Overview
Hyperliquid is a blockchain designed for on-chain trading with speed and fees that approach centralized exchange performance. The architecture consists of two interconnected components:
HyperCore - The on-chain order book engine that manages trade execution and provides market data. HyperCore exposes multiple real-time data streams through gRPC, JSON-RPC/HTTP, and WebSocket APIs — with protocol availability varying by stream type (see Available Data Streams below).
HyperEVM - An EVM-compatible execution layer for smart contract deployment and interaction. Developers can launch new asset classes, build trading strategy vaults, create DeFi protocols, and manage digital assets using standard Ethereum JSON-RPC methods. HyperEVM supports all major Ethereum development tools including Foundry, Hardhat, Web3.js, Ethers.js, and Viem.
Both components operate under HyperBFT consensus (based on HotStuff) and use the native HYPE token for transaction fees.
Please note that to access Hyperliquid's JSON-RPC API, WebSocket (WSS), and gRPC streaming, you need a Quicknode Build plan or higher. View pricing to upgrade.
Interacting with Hyperliquid's APIs
Quicknode provides access to both Hyperliquid components through specialized APIs designed for different use cases:
HyperEVM APIs
HyperEVM supports standard Ethereum JSON-RPC methods, allowing developers to use familiar Ethereum tools like Foundry, Hardhat, and Web3 libraries without modification. Access HyperEVM through two specialized paths:
/evm path - Standard blockchain operations including account balances, transaction queries, smart contract calls (eth_call), gas estimation, and transaction broadcasting. This path is designed for read operations and high-frequency queries.
/nanoreth path - Provides all standard methods plus advanced debugging capabilities (debug_traceTransaction, debug_storageRangeAt), transaction tracing (trace_transaction, trace_block, trace_filter), WebSocket support for real-time blockchain events, and extended historical data archive. This path also supports historical eth_call queries on any block, whereas /evm only supports the latest block.
Compatible with: Foundry, Hardhat, Truffle, Web3.js, Ethers.js, Viem, Metamask, and all standard Ethereum development frameworks.
Due to Hyperliquid's architectural differences, some RPC methods may behave differently from Ethereum. We recommend cross-referencing with the official Hyperliquid documentation for the latest updates.
Cross-layer integration: Smart contracts on HyperEVM can read HyperCore oracle prices. See our guide on accessing HyperCore data from contracts.
HyperCore APIs
HyperCore provides real-time and historical access to exchange data through multiple API protocols:
Info Endpoint (/info path) - Query comprehensive market data, user positions, order status, trading history, vault information, and exchange state through 50+ specialized info methods. Access real-time prices, order books, funding rates, user fills, portfolio data, and historical market information through simple POST requests.
REST API - Trading operations (build and send orders with signatures), builder fee approval management, market discovery (list markets/DEXes, open orders, order status), and order validation (preflight). Supports order lifecycle management from building unsigned actions to submitting signed transactions, with enhanced endpoints for checking approval status and querying enriched order data.
If you are on a free trial plan, we provide a URL for you to use, but it is not specific to your Quicknode account. Please see hyperliquidapi.com for details and our Discord for support.
JSON-RPC/HTTP (/hypercore path) - Historical exchange data queries (hl_getLatestBlocks, hl_getBlock, hl_getBatchBlocks) for backfilling and batch processing of up to 200 blocks per request.
gRPC Streaming (port 10000) - Bidirectional streaming with sub-millisecond latency for market data. Supports all nine data streams with native zstd compression (reduces bandwidth by ~70%), including StreamL2Book (aggregated depth) and StreamL4Book (individual order) with built-in snapshots. Suitable for market makers, algorithmic trading systems, and real-time analytics applications requiring low latency.
WebSocket (/hypercore/ws path) - Browser-compatible real-time subscriptions using standard WebSocket libraries. JSON-based protocol with hl_subscribe and hl_unsubscribe methods. Supports six data streams (TRADES, ORDERS, BOOK_UPDATES, TWAP, EVENTS, WRITER_ACTIONS). BLOCKS, StreamL2Book, and StreamL4Book are gRPC-only. Suitable for web-based trading dashboards, price monitors, and portfolio trackers.
Available Data Streams
| Stream | Description | gRPC | WebSocket | JSON-RPC |
|---|---|---|---|---|
| TRADES | Executed trades with maker/taker info | ✓ | ✓ | ✓ |
| ORDERS | Order lifecycle events (18+ status types) | ✓ | ✓ | ✓ |
| BOOK_UPDATES | Incremental order book changes | ✓ | ✓ | ✓ |
| TWAP | TWAP algorithm execution data | ✓ | ✓ | ✓ |
| EVENTS | Balance changes, transfers, liquidations | ✓ | ✓ | ✓ |
| WRITER_ACTIONS | HyperCore ↔ HyperEVM bridge data | ✓ | ✓ | ✓ |
| BLOCKS | Raw blockchain data (replica_cmds) | ✓ | — | — |
| StreamL2Book | Aggregated price-level depth (full snapshot every block) | ✓ | — | — |
| StreamL4Book | Individual order book (snapshot + diffs per block) | ✓ | — | — |
All streams support filtering by user addresses, trading pairs, and more. Filter limits vary by plan tier.
Learn more about HyperCore data streams and filtering.
Supported SDKs
QuickNode maintains open-source SDKs for Hyperliquid in multiple languages. These SDKs handle transaction building, signing, and submission for HyperCore trading operations and HyperEVM interactions.
Available SDKs:
- Python - hyperliquid-sdk on PyPI
- TypeScript/JavaScript - @quicknode/hyperliquid-sdk on npm
- Rust - quicknode-hyperliquid-sdk on crates.io
- Go - Available in the SDK repository
All SDKs are open source and available on GitHub. The SDKs integrate with QuickNode endpoints for accessing /info, /exchange, /evm, /nanoreth, /hypercore, and gRPC streams. They can be used with or without a QuickNode endpoint.
Make Hyperliquid API Calls
To start building on Hyperliquid, create a Quicknode endpoint and access both HyperEVM and HyperCore services.
Quicknode provides managed Hyperliquid infrastructure, giving you access to both components without running your own nodes. These endpoints offer:
- Reliability - Globally distributed infrastructure to minimize downtime
- Performance - Low latency and request handling for production applications
- Dual-component access - Single endpoint provides access to both HyperEVM (smart contracts via
/evmand/nanoreth) and HyperCore (exchange data via/hypercoreHTTP/WebSocket and gRPC) - Multiple protocols - HTTP, WebSocket, and gRPC streaming support
- Ecosystem integration - Additional functionality through APIs (add-ons) on the Quicknode Marketplace and products like Streams
Visit the QuickStart page to create your endpoint and send your first request.
Supported Networks
Quicknode provides access to the following Hyperliquid networks:
*HyperEVM Data Availability:
/evm - Partial historical data; availability varies based on Hyperliquid's peering model. Designed for standard queries on recent blocks.
/nanoreth - Extended historical archive with full tracing support. Includes all debug and trace methods plus WebSocket functionality.
HyperCore Data Availability:
/info (HTTP) - Comprehensive market data and user information via 50+ info methods (meta, clearinghouseState, userFills, l2Book, portfolio, etc.)
REST API - Trading operations (build/send orders, cancel, modify), builder fee management (approve/revoke), market queries (list markets/DEXes, open orders, order status), and order validation (preflight)
/hypercore (HTTP) - Historical block queries (hl_getLatestBlocks, hl_getBlock, hl_getBatchBlocks)
/hypercore/ws (WebSocket) - Real-time streaming for 6 data streams (TRADES, ORDERS, BOOK_UPDATES, TWAP, EVENTS, WRITER_ACTIONS)
gRPC - Real-time streaming for all 9 data streams with zstd compression support
HyperEVM: /evm (HTTP only) • /nanoreth (HTTP + WebSocket + tracing/debugging)
HyperCore: /info (50+ info methods) • /hypercore/.. REST API (trading & market queries) • /hypercore (historical block queries) • /hypercore/ws WebSocket (6 streams) • gRPC (9 streams including StreamL2Book/StreamL4Book + compression)
Learn more about HyperEVM and HyperCore endpoints
Complete reference for developers building on Hyperliquid with Quicknode:
QuickStart
Get started with Hyperliquid quickly. Follow our step-by-step quickstart to set up your endpoint and make your first API request.
Provider Endpoints
Learn how to configure and manage your Hyperliquid endpoints for optimal performance and reliability.
API Overview
Explore supported APIs, networks, Quicknode products, and enhanced API features for building powerful applications.
Marketplace
Discover and integrate powerful add-ons and tools from the Quicknode Marketplace to enhance your web3 applications.
Endpoint Security
Secure your endpoints with authentication, whitelisting, and best security practices.
Error Codes
Understand common error codes and troubleshooting steps for Hyperliquid API requests.