JSON-RPC

Overview

The JSON-RPC endpoint provides a standard EVM-compatible interface to the Hyperliquid node. It proxies to the local node’s :3001/evm endpoint through the Nginx gateway with TLS, authentication, and rate limiting.

Endpoints

Region	URL
US (East US 2)	https://rpc.aleatoric.systems
JP (Japan East)	https://rpc-jp.aleatoric.systems

Supported Methods

All standard eth_* methods are supported:

• eth_blockNumber — Current block number
• eth_getBlockByNumber / eth_getBlockByHash — Block data
• eth_getBalance — Account balance
• eth_getTransactionByHash — Transaction details
• eth_getTransactionReceipt — Receipt with logs
• eth_call — Read-only contract call
• eth_getLogs — Event log queries
• eth_chainId — Chain identifier

Example

curl -X POST https://rpc.aleatoric.systems \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  }'

Response:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x138e3f0"
}

Rate Limits

• Global: 5,000 req/s per API key at Nginx level
• Tier-specific limits apply (see Rate Limits)