Hyperliquid Validator tools & documentation

Home·Validation Tools·hyperliquid

hyperliquid

MAINNET

Overview Rpc

Learn how to interact with hyperliquid nodes using different endpoint types.

#Available Endpoints

Service	Endpoint
REST API	`Not available`
RPC	`Not available`
gRPC	`Not available`
WebSocket	`Not available`
JSON-RPC	`https://hyperliquid.lavenderfive.com:443/evm`
WS-JSON-RPC	`wss://hyperliquid.lavenderfive.com:443/evm/ws`

ⓘ Some endpoints may require an API key for access. You can get one by signing up with the yellow "API KEY" button on this page or visit lavenderfive.com/api.

#🌐 Usage Examples

#JSON-RPC Examples

curl -X POST "https://hyperliquid.lavenderfive.com:443/evm" \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-uuid" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  }'

#WebSocket JSON-RPC Examples

const ws = new WebSocket('wss://hyperliquid.lavenderfive.com:443/evm/ws');
// Add API key to connection
ws.onopen = () => {
  ws.send(JSON.stringify({
    type: 'auth',
    api_key: 'your-api-key-uuid'
  }));
};

#🔑 Common Response Codes

Code	Description
200	Successful request
400	Bad request / Invalid parameters
401	Unauthorized / Invalid API key
404	Resource not found
429	Too many requests
500	Internal server error

⚠ Rate limits may apply to endpoints. Please use for testing and get a trial API-key to try out a fully unlimited api for 14 days.

Chain ID:

The unique identifier for the blockchain network.

Latest Version:

The latest version of the chain software.

Public endpoints

Public endpoints are rate limited but can be used for basic CLI usage, node syncing or testing environments. Request an API key for enhanced access limits, we offer free trial periods of 14 days and cheap shared access plans from $50 a month.

Json-RPC

JSON-RPC endpoint for EVM interactions and queries. This is the main endpoint for Ethereum like networks but might co-exist alongside a consensus RPCs on Cosmos like networks that have a separate consensus endpoint like Berachain, Story and Evmos.

hyperliquid.lavenderfive.com:443/evm

Json-RPC (websocket)

The websocket interface for the json-RPC EVM endpoint to listen/subscribe to event feeds.

wss://hyperliquid.lavenderfive.com:443/evm/ws

hyperliquid Validator Tools & Infrastructure Documentation

#Available Endpoints

#🌐 Usage Examples

#JSON-RPC Examples

#WebSocket JSON-RPC Examples

#🔑 Common Response Codes