# Hyperliquid — Managed Infrastructure for the Fastest Onchain Orderbook

Build trading bots, analytics dashboards, and DeFi apps on Hyperliquid with enterprise-grade RPC, gRPC streaming, and a purpose-built SDK for Hyperliquid.

## Overview

HyperCore for Hyperliquid is Quicknode's managed infrastructure for the Hyperliquid L1 — the only provider with full HyperCore and HyperEVM coverage under a single endpoint. Access 50+ info methods, historical block data, standard EVM JSON-RPC, advanced tracing, and 9 gRPC streams including exclusive L2 and L4 orderbook depth.

**URL:** https://www.quicknode.com/chains/hyperliquid

## Key Features

- **Single Endpoint, Full Coverage** — One base URL serves four API paths (`/info`, `/hypercore`, `/evm`, `/nanoreth`) plus gRPC on port `:10000`. No juggling multiple providers.
- **9 gRPC Streams** — Real-time trades, orders, book updates, TWAP, events, blocks, writer actions, and gRPC-exclusive L2 and L4 orderbook depth with zstd compression.
- **Purpose-Built SDK** — TypeScript, Python, Go, and Rust clients with one-line trading, fluent order builders, and typed access to every API surface.
- **Higher Rate Limits** — 50–500 RPS depending on plan, well above Hyperliquid's public API limits.
- **Enterprise Reliability** — 99.99% uptime SLA, SOC 1/2 Type II and ISO 27001 certified.

## API Paths

### /info — Market Data and User State
50+ HyperCore info methods covering market data, user positions, vault details, delegations, borrow/lend state, funding history, and exchange metadata.

### /hypercore — Historical Blocks and Order Management
Query historical block data across all stream types (trades, orders, book updates). Build, sign, and send orders programmatically with preflight validation.

### /evm — Standard Ethereum JSON-RPC
Full Ethereum JSON-RPC for HyperEVM (chain ID 999). Accounts, transactions, blocks, logs, gas estimation — everything you need for smart contract interaction on HyperEVM.

### /nanoreth — Advanced HyperEVM
Tracing, debugging, and system transaction access for HyperEVM. Includes `debug_traceTransaction`, `trace_block`, and HyperEVM-specific methods like `eth_getSystemTxsByBlockNumber`.

## gRPC Streaming

Nine real-time data streams available on port `:10000` with `x-token` authentication:

| Stream | Description | Availability |
|--------|-------------|--------------|
| Trades | Executed trades with price, size, and side | gRPC + WebSocket |
| Orders | Full order lifecycle with 18+ status types | gRPC + WebSocket |
| Book Updates | L2 orderbook changes (deltas) | gRPC + WebSocket |
| TWAP | TWAP algorithm execution data | gRPC + WebSocket |
| Events | Funding payments, liquidations, governance | gRPC + WebSocket |
| Writer Actions | Spot token transfers and system writes | gRPC + WebSocket |
| Blocks | Raw HyperCore blockchain data | gRPC only |
| **StreamL2Book** | Aggregated depth snapshots by price level | **gRPC only** |
| **StreamL4Book** | Individual order-level depth with diffs | **gRPC only** |

All streams support zstd compression for ~70% bandwidth reduction and field-level filtering.

**StreamL2Book** delivers full depth snapshots every block — ideal for depth charts and price displays. **StreamL4Book** provides individual order visibility (wallet address, order ID, queue position) — built for market makers and HFT systems.

## SDK

A purpose-built SDK for Hyperliquid available in four languages:

- **TypeScript:** `npm install @quicknode/hyperliquid-sdk`
- **Python:** `pip install hyperliquid-sdk`
- **Go:** `go get github.com/quiknode-labs/hyperliquid-sdk/go`
- **Rust:** `cargo add quicknode-hyperliquid-sdk`

### Sub-Clients
| Client | Surface | Methods |
|--------|---------|---------|
| `sdk.info` | Market data, user state, vaults, delegations | 50+ |
| `sdk.core` | Block queries, order management, build-sign-send | 30+ |
| `sdk.evm` | Ethereum JSON-RPC for HyperEVM | 50+ |
| `sdk.stream` | WebSocket subscriptions | 20+ |
| `sdk.grpc` | gRPC streaming (all 9 streams) | 9 |

### One-Line Trading
```typescript
await sdk.marketBuy("BTC", { size: 0.001 });
await sdk.marketSell("ETH", { notional: 100 });
await sdk.buy("BTC", { size: 0.001, price: 65000 });
```

### Fluent Order Builder
```typescript
import { Order } from '@quicknode/hyperliquid-sdk';
await sdk.order(Order.buy("BTC").size(0.001).price(65000).gtc().reduceOnly());
```

Supports market, limit, stop-loss, take-profit, TWAP, and scale orders. Trigger orders, leverage management, vault deposits, staking, and cross-account transfers are all built in.

**44 runnable examples** in the [examples repository](https://github.com/quiknode-labs/hyperliquid-examples).

## Streams Integration

Use Quicknode Streams for push-based filtered delivery of Hyperliquid data:

- Write JavaScript filter functions that run on every block or event
- Matching data delivered to webhooks automatically
- Historical backfills available for replaying past data
- No polling, no WebSocket management — just filtered pushes

## Use Cases

- **Trading Bots and HFT** — Low-latency order execution with gRPC streaming and one-line SDK trading
- **Portfolio Trackers** — Real-time position, P&L, and funding data via WebSocket and Info API
- **Orderbook Visualization** — L2 depth charts and L4 individual-order views via gRPC-exclusive streams
- **Whale Monitoring and Alerts** — Track large orders and liquidations with Streams push delivery
- **DeFi Analytics on HyperEVM** — Standard EVM tooling (Hardhat, Foundry, ethers.js) works out of the box on chain ID 999

## Developer Resources

### Published Guides
- [Real-Time Portfolio Tracker](https://www.quicknode.com/guides/hyperliquid/build-portfolio-tracker-using-hypercore-data) — Build a live portfolio dashboard with React and TypeScript
- [Whale Alert Bot](https://www.quicknode.com/guides/hyperliquid/real-time-hyperliquid-whale-alert-bot) — Stream large trades to Telegram using Quicknode Streams
- [Read HyperCore Oracle Prices in HyperEVM](https://www.quicknode.com/guides/hyperliquid/read-hypercore-oracle-prices-in-hyperevm) — Access oracle data from Solidity smart contracts
- [Bridge with Chainlink CCIP](https://www.quicknode.com/guides/hyperliquid/bridge-on-hyperliquid-with-chainlink-ccip) — Cross-chain bridging to Hyperliquid using Foundry

### Documentation and Code
- Hyperliquid RPC Docs: https://www.quicknode.com/docs/hyperliquid
- SDK Docs: https://www.quicknode.com/docs/hyperliquid-sdk
- GitHub Examples: https://github.com/quiknode-labs/hyperliquid-api-examples

## Why Quicknode vs. Native Hyperliquid API

| | Quicknode | Native HL API |
|---|---|---|
| Rate limits | 50–500 RPS | Public tier limits |
| Uptime SLA | 99.99% guaranteed | Best-effort |
| Push delivery | Streams (filtered webhooks) | Not available |
| L2/L4 orderbook | gRPC with managed infra | Self-hosted only |
| Compliance | SOC 1/2, ISO 27001 | None |
| Multi-chain | 78+ chains from one platform | Hyperliquid only |
| SDK | TypeScript, Python, Go, Rust | Python, Rust (official) |

## Pricing

- **Free trial:** 1 month, 10M credits, 15 RPS
- **Build:** From $49/mo
- **Scale:** Up to $999/mo
- **Enterprise:** Custom pricing with dedicated infrastructure

## Get Started
- Create Endpoint: https://www.quicknode.com/signup
- Documentation: https://www.quicknode.com/docs/hyperliquid
- Landing Page: https://hyperliquidapi.com
- Contact Sales: https://www.quicknode.com/contact-us
