Hyperliquid via Dwellir
Hyperliquid is a purpose-built L1 blockchain optimized for trading. Dwellir runs its own Hyperliquid nodes and offers infrastructure beyond standard RPC: a custom gRPC gateway for Hypercore data, a real-time order book server, and a filtering Info API proxy, with edge servers in Singapore and Tokyo.
How Hyperliquid Works
Hyperliquid has two layers:
HyperCore is the native trading layer. Fully on-chain perpetual futures and spot order books. Every order, cancellation, trade, and liquidation settles within one block. Handles ~200,000 orders/second with sub-second finality via HyperBFT consensus.
HyperEVM is a general-purpose EVM smart contract layer that runs alongside HyperCore. Developers can deploy Solidity contracts that interact with HyperCore's liquidity. Chain ID: 999. Native gas token: HYPE.
Key properties:
- All order books are fully on-chain (no off-chain matching)
- Sub-second block times with one-block finality
- Perpetuals support up to 40x leverage (BTC); most assets 3-10x
- Native spot trading with HIP-3 DEX deployment
What Dwellir Provides
Dwellir runs full Hyperliquid infrastructure: the official HL node, plus custom software built by Dwellir and the community for serving specific data channels.
For current pricing, features, and service details, see Dwellir Hyperliquid docs and Pricing.
| Endpoint |
What It Serves |
Protocol |
Reference |
| HyperEVM JSON-RPC |
EVM state, smart contracts, blocks |
HTTPS + WSS |
hyperevm-json-rpc.md |
| Info API proxy |
Market data, user state, metadata |
HTTPS (POST) |
info-api.md |
| L1 gRPC Gateway |
Hypercore block/fill/orderbook streaming |
gRPC |
grpc-gateway.md |
| Orderbook WebSocket |
Real-time L2/L4 order book data |
WSS only |
orderbook-websocket.md |
| Dedicated Node |
Full stack, uncapped throughput |
All |
See below |
Dwellir CLI
The Dwellir CLI (dwellir) provides terminal access to endpoint discovery, API key management, usage monitoring, and documentation. Useful for quickly finding Hyperliquid endpoint URLs, reading docs without leaving the terminal, and managing keys in CI pipelines. See dwellir-cli.md.
# Install
curl -fsSL https://raw.githubusercontent.com/dwellir-public/cli/main/scripts/install.sh | sh
# Find all Hyperliquid endpoints
dwellir endpoints search hyperliquid
# Read Hyperliquid docs as markdown
dwellir docs search hyperliquid
dwellir docs get hyperliquid/info-endpoint
# Manage API keys and check usage
dwellir keys list
dwellir usage summary
What Dwellir Does NOT Proxy
Exchange API: Order placement, cancellation, transfers, and other write operations require EIP-712 signatures and go directly to api.hyperliquid.xyz/exchange. See native-api.md.
Native WebSocket: Hyperliquid's subscription WebSocket (wss://api.hyperliquid.xyz/ws) for user events, trades, and candles is separate from Dwellir's Orderbook WebSocket. See native-api.md.
Read vs Write Architecture
┌─────────────────────────────────────────────────────────┐
│ Your Application │
├──────────────────┬──────────────────────────────────────┤
│ READ (Dwellir) │ WRITE (Hyperliquid native) │
│ │ │
│ EVM state ──────┤ Place orders ─── api.hyperliquid.xyz │
│ Info queries ───┤ Cancel orders /exchange │
│ gRPC streams ───┤ Transfers (requires sig) │
│ Order book ─────┤ Set leverage │
└──────────────────┴──────────────────────────────────────┘
When to Use Which Reference
| You want to... |
Use this reference |
| Deploy or interact with Solidity contracts on HyperEVM |
hyperevm-json-rpc.md |
| Query EVM state (balances, logs, blocks) |
hyperevm-json-rpc.md |
| Get market data (prices, order books, candles, funding rates) |
info-api.md |
| Query user positions, orders, fills, or balances |
info-api.md |
| Get perpetuals/spot metadata (universe, leverage, assets) |
info-api.md |
| Stream real-time order book updates with deep levels |
orderbook-websocket.md |
| Build market-making or arbitrage systems |
orderbook-websocket.md |
| Stream L1 block data or fill executions |
grpc-gateway.md |
| Build indexers or data pipelines from Hypercore |
grpc-gateway.md |
| Place, cancel, or modify orders |
native-api.md |
| Subscribe to user events, trades, or candle updates |
native-api.md |
| Access historical trade/fill data |
historical-data.md |
| Discover endpoint URLs, manage API keys, or read docs from the terminal |
dwellir-cli.md |
Dedicated Nodes
Full Hyperliquid stack on single-tenant infrastructure. No shared rate limits, uncapped throughput. Available in Tokyo (mainnet) and testnet configurations.
A dedicated node includes all Dwellir services (EVM JSON-RPC, Info API, gRPC Gateway, Orderbook Server) on isolated infrastructure.
For current pricing and configuration options, see Dwellir Hyperliquid Pricing.
Contact sales or subscribe via dashboard.dwellir.com.
Best Practices
Use Dwellir for reads, Hyperliquid native for writes. Dwellir provides the data infrastructure; order placement requires signatures and goes through api.hyperliquid.xyz/exchange.
Use the gRPC gateway for latency-sensitive streaming. The gRPC endpoint reads from disk and has lower latency than HTTP polling the Info API.
Use Dwellir's Orderbook WebSocket for book data. It's optimized for order book delivery with edge servers in Singapore and Tokyo.
Batch Info API queries. Fetch combined endpoints like metaAndAssetCtxs (via public API) rather than per-asset queries. Check Info API docs for which types are available on the Dwellir proxy vs public endpoint.
Cache metadata. meta, spotMeta, and perpDexs are semi-static. Cache for 1-5 minutes.
Use l2Book via Info API for snapshots, Orderbook WS for streaming. The Info API gives point-in-time snapshots; the Orderbook WebSocket gives continuous updates.
Documentation Links
1---2name: hyperliquid3description: Hyperliquid L1 reference for Dwellir endpoints: HyperEVM JSON-RPC, Info API proxy, gRPC L1 streaming, order book WebSocket, dedicated nodes, and trading patterns. Covers HyperCore trading layer, HyperEVM smart contracts (chain ID 999), market data queries, perpetuals metadata, spot markets, and best practices. Use when working with Hyperliquid, HYPE, HyperEVM, HyperCore, perpetual futures, order books, funding rates, or Hyperliquid trading through Dwellir. Triggers on mentions of hyperliquid, HYPE, HyperEVM, HyperCore, order book, perpetuals, funding rate, l2Book, l4Book, gRPC streaming, nanoreth, or hyperliquid trading.4---56# Hyperliquid via Dwellir78Hyperliquid is a purpose-built L1 blockchain optimized for trading. Dwellir runs its own Hyperliquid nodes and offers infrastructure beyond standard RPC: a custom gRPC gateway for Hypercore data, a real-time order book server, and a filtering Info API proxy, with edge servers in Singapore and Tokyo.910## How Hyperliquid Works1112Hyperliquid has two layers:1314**HyperCore** is the native trading layer. Fully on-chain perpetual futures and spot order books. Every order, cancellation, trade, and liquidation settles within one block. Handles ~200,000 orders/second with sub-second finality via HyperBFT consensus.1516**HyperEVM** is a general-purpose EVM smart contract layer that runs alongside HyperCore. Developers can deploy Solidity contracts that interact with HyperCore's liquidity. Chain ID: **999**. Native gas token: **HYPE**.1718Key properties:19- All order books are fully on-chain (no off-chain matching)20- Sub-second block times with one-block finality21- Perpetuals support up to 40x leverage (BTC); most assets 3-10x22- Native spot trading with HIP-3 DEX deployment2324## What Dwellir Provides2526Dwellir runs full Hyperliquid infrastructure: the official HL node, plus custom software built by Dwellir and the community for serving specific data channels.2728For current pricing, features, and service details, see [Dwellir Hyperliquid docs](https://www.dwellir.com/docs/hyperliquid) and [Pricing](https://www.dwellir.com/docs/hyperliquid/pricing).2930| Endpoint | What It Serves | Protocol | Reference |31|----------|---------------|----------|-----------|32| **HyperEVM JSON-RPC** | EVM state, smart contracts, blocks | HTTPS + WSS | [hyperevm-json-rpc.md](references/hyperevm-json-rpc.md) |33| **Info API proxy** | Market data, user state, metadata | HTTPS (POST) | [info-api.md](references/info-api.md) |34| **L1 gRPC Gateway** | Hypercore block/fill/orderbook streaming | gRPC | [grpc-gateway.md](references/grpc-gateway.md) |35| **Orderbook WebSocket** | Real-time L2/L4 order book data | WSS only | [orderbook-websocket.md](references/orderbook-websocket.md) |36| **Dedicated Node** | Full stack, uncapped throughput | All | See below |3738### Dwellir CLI3940The [Dwellir CLI](https://www.dwellir.com/docs/cli) (`dwellir`) provides terminal access to endpoint discovery, API key management, usage monitoring, and documentation. Useful for quickly finding Hyperliquid endpoint URLs, reading docs without leaving the terminal, and managing keys in CI pipelines. See [dwellir-cli.md](references/dwellir-cli.md).4142```bash43# Install44curl -fsSL https://raw.githubusercontent.com/dwellir-public/cli/main/scripts/install.sh | sh4546# Find all Hyperliquid endpoints47dwellir endpoints search hyperliquid4849# Read Hyperliquid docs as markdown50dwellir docs search hyperliquid51dwellir docs get hyperliquid/info-endpoint5253# Manage API keys and check usage54dwellir keys list55dwellir usage summary56```5758### What Dwellir Does NOT Proxy5960**Exchange API**: Order placement, cancellation, transfers, and other write operations require EIP-712 signatures and go directly to `api.hyperliquid.xyz/exchange`. See [native-api.md](references/native-api.md).6162**Native WebSocket**: Hyperliquid's subscription WebSocket (`wss://api.hyperliquid.xyz/ws`) for user events, trades, and candles is separate from Dwellir's Orderbook WebSocket. See [native-api.md](references/native-api.md).6364### Read vs Write Architecture6566```67┌─────────────────────────────────────────────────────────┐68│ Your Application │69├──────────────────┬──────────────────────────────────────┤70│ READ (Dwellir) │ WRITE (Hyperliquid native) │71│ │ │72│ EVM state ──────┤ Place orders ─── api.hyperliquid.xyz │73│ Info queries ───┤ Cancel orders /exchange │74│ gRPC streams ───┤ Transfers (requires sig) │75│ Order book ─────┤ Set leverage │76└──────────────────┴──────────────────────────────────────┘77```7879## When to Use Which Reference8081| You want to... | Use this reference |82|----------------|-------------------|83| Deploy or interact with Solidity contracts on HyperEVM | [hyperevm-json-rpc.md](references/hyperevm-json-rpc.md) |84| Query EVM state (balances, logs, blocks) | [hyperevm-json-rpc.md](references/hyperevm-json-rpc.md) |85| Get market data (prices, order books, candles, funding rates) | [info-api.md](references/info-api.md) |86| Query user positions, orders, fills, or balances | [info-api.md](references/info-api.md) |87| Get perpetuals/spot metadata (universe, leverage, assets) | [info-api.md](references/info-api.md) |88| Stream real-time order book updates with deep levels | [orderbook-websocket.md](references/orderbook-websocket.md) |89| Build market-making or arbitrage systems | [orderbook-websocket.md](references/orderbook-websocket.md) |90| Stream L1 block data or fill executions | [grpc-gateway.md](references/grpc-gateway.md) |91| Build indexers or data pipelines from Hypercore | [grpc-gateway.md](references/grpc-gateway.md) |92| Place, cancel, or modify orders | [native-api.md](references/native-api.md) |93| Subscribe to user events, trades, or candle updates | [native-api.md](references/native-api.md) |94| Access historical trade/fill data | [historical-data.md](references/historical-data.md) |95| Discover endpoint URLs, manage API keys, or read docs from the terminal | [dwellir-cli.md](references/dwellir-cli.md) |9697## Dedicated Nodes9899Full Hyperliquid stack on single-tenant infrastructure. No shared rate limits, uncapped throughput. Available in Tokyo (mainnet) and testnet configurations.100101A dedicated node includes all Dwellir services (EVM JSON-RPC, Info API, gRPC Gateway, Orderbook Server) on isolated infrastructure.102103For current pricing and configuration options, see [Dwellir Hyperliquid Pricing](https://www.dwellir.com/docs/hyperliquid/pricing).104105Contact sales or subscribe via [dashboard.dwellir.com](https://dashboard.dwellir.com).106107## Best Practices1081091. **Use Dwellir for reads, Hyperliquid native for writes.** Dwellir provides the data infrastructure; order placement requires signatures and goes through `api.hyperliquid.xyz/exchange`.1101112. **Use the gRPC gateway for latency-sensitive streaming.** The gRPC endpoint reads from disk and has lower latency than HTTP polling the Info API.1121133. **Use Dwellir's Orderbook WebSocket for book data.** It's optimized for order book delivery with edge servers in Singapore and Tokyo.1141154. **Batch Info API queries.** Fetch combined endpoints like `metaAndAssetCtxs` (via public API) rather than per-asset queries. Check [Info API docs](https://www.dwellir.com/docs/hyperliquid/info-endpoint) for which types are available on the Dwellir proxy vs public endpoint.1161175. **Cache metadata.** `meta`, `spotMeta`, and `perpDexs` are semi-static. Cache for 1-5 minutes.1181196. **Use `l2Book` via Info API for snapshots, Orderbook WS for streaming.** The Info API gives point-in-time snapshots; the Orderbook WebSocket gives continuous updates.120121## Documentation Links122123- Dwellir Hyperliquid docs: [dwellir.com/docs/hyperliquid](https://www.dwellir.com/docs/hyperliquid)124- Dwellir L1 gRPC Gateway: contact support@dwellir.com for source access125- Dwellir Orderbook Server: contact support@dwellir.com for source access126- Dwellir REST Server: contact support@dwellir.com for source access127- Hyperliquid API docs: [hyperliquid.gitbook.io](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api)128- Hyperliquid Python SDK: [github.com/hyperliquid-dex/hyperliquid-python-sdk](https://github.com/hyperliquid-dex/hyperliquid-python-sdk)129- Dwellir dashboard: [dashboard.dwellir.com](https://dashboard.dwellir.com)130- Dwellir support: support@dwellir.com
enuno