Hyperliquid (HyperEVM)

Access the HyperEVM blockchain through JSON-RPC API. HyperEVM is the Ethereum-compatible smart contract layer of Hyperliquid, enabling direct integration with one of the most performant decentralized

Overview

HyperEVM is an Ethereum Virtual Machine (EVM) execution layer embedded within Hyperliquid's Layer 1 blockchain. It shares state with HyperCore (the trading engine) and is secured by the same HyperBFT consensus mechanism. This unique architecture allows smart contracts to directly access Hyperliquid's on-chain order books, spot trading, and perpetual markets.

Key Features

• EVM Compatibility: Full Ethereum tooling support (Foundry, Hardhat, ethers.js, web3.js)

• Unified State: Smart contracts can interact directly with HyperCore trading infrastructure

• HyperBFT Consensus: Sub-second finality with high throughput

• EIP-1559 Support: Cancun hardfork (without blobs) with base fee mechanism

• Native HYPE Token: Gas payments in HYPE with 18 decimals

• Fee Burning: Both base fees and priority fees are burned

TECHNICAL DISCLAIMER: AUTHORITATIVE JSON-RPC API SPECIFICATION.

GetBlock's RPC API reference documentation is provided exclusively for informational purposes and to optimize the developer experience. The canonical and normative specification for Ethereum Virtual Machine (EVM) JSON-RPC methods is solely maintained and published through the official Ethereum Foundation documentation portal at ethereum.org. This resource constitutes the sole authoritative reference implementation of the JSON-RPC 2.0 protocol interface across EVM-compatible execution clients.

Supported Network

Network	Chain ID	JSON	WSS
Mainnet	999	✔	✔

Base URL

New York, USA

https://go.getblock.us

Frankfurt, Germany

Signapore, Signapore

Available API Methods

Standard Ethereum Methods

Method	Description	Limitations
eth_blockNumber	Get current block number	-
eth_chainId	Get chain ID	-
eth_gasPrice	Get gas price for next small block	-
eth_getBalance	Get account balance	Latest block only
eth_getBlockByHash	Get block by hash	-
eth_getBlockByNumber	Get block by number	-
eth_getBlockReceipts	Get all receipts in block	-
eth_getBlockTransactionCountByHash	Get tx count by block hash	-
eth_getBlockTransactionCountByNumber	Get tx count by block number	-
eth_getCode	Get contract bytecode	Latest block only
eth_getLogs	Get event logs	Max 4 topics, 50 blocks
eth_getStorageAt	Get storage value	Latest block only
eth_getTransactionByHash	Get transaction by hash	-
eth_getTransactionByBlockHashAndIndex	Get tx by block hash and index	-
eth_getTransactionByBlockNumberAndIndex	Get tx by block number and index	-
eth_getTransactionCount	Get account nonce	Latest block only
eth_getTransactionReceipt	Get transaction receipt	-
eth_call	Execute call without transaction	Latest block only
eth_estimateGas	Estimate gas for transaction	Latest block only
eth_feeHistory	Get historical fee data	-
eth_maxPriorityFeePerGas	Get priority fee suggestion	Always returns 0
eth_syncing	Get sync status	Always returns false
net_version	Get network ID	-
web3_clientVersion	Get client version	-

HyperEVM-Specific Methods

Method	Description
eth_bigBlockGasPrice	Get gas price for next big block
eth_usingBigBlocks	Check if address uses big blocks
eth_getSystemTxsByBlockHash	Get HyperCore system transactions by block hash
eth_getSystemTxsByBlockNumber	Get HyperCore system transactions by block number

Quickstart

In this section, you will learn how to make your first call with either:

• Axios

• Python

Quickstart with Axios

Before you begin, you must have already installed npm or yarn on your local machine. If not, check out npm or yarn.

1. Set up your project using this command:

npm

mkdir hyperevm-api-quickstart
cd hyperevm-api-quickstart
npm init --yes

yarn

This creates a project directory named hyperevm-api-quickstart and initialises a Node.js project within it.

1. Install Axios using this command:

npm

npm install axios

yarn

1. Create a new file and name it index.js. This is where you will make your first call.

2. Set the ES module "type": "module" in your package.json.

3. Add the following code to the file (index.js):

   import axios from 'axios'
   let data = JSON.stringify({
     jsonrpc: "2.0",
     method: "eth_blockNumber",
     params: [],
     id: "getblock.io",
   });
   
   let config = {
     method: "post",
     maxBodyLength: Infinity,
     url: "https://go.getblock.us/<ACCESS_TOKEN>",
     headers: {
       "Content-Type": "application/json",
     },
     data: data,
   };
   
   axios
     .request(config)
     .then((response) => {
       console.log(JSON.stringify(response.data));
     })
     .catch((error) => {
       console.log(error);
     });
   

   Replace <ACCESS_TOKEN> with your actual access token from GetBlock.

4. Run the script:

   node index.js

   The sequence number and authentication key log in your console like this:

   {
       "jsonrpc": "2.0",
       "id": "getblock.io",
       "result": "0x15776ea"
   }

Quickstart with Python and Requests

Before you begin, you must have installed Python and Pip on your local machine.

1. Set up your project using this command:

   mkdir arbitrum-api-quickstart
   cd arbitrum-api-quickstart

2. Set up a virtual environment to isolate dependencies:

   python -m venv venv
   source venv/bin/activate  
   # On Windows, use venv\Scripts\activate

3. Install the requests library:

   pip install requests

4. Create a new file called main.py and insert the following code:

   import requests
   import json
   
   url = "https://go.getblock.us/<ACCESS_TOKEN>"
   
   payload = json.dumps({
     "jsonrpc": "2.0",
     "method": "eth_blockNumber",
     "params": [],
     "id": "getblock.io"
   })
   headers = {
     'Content-Type': 'application/json'
   }
   
   response = requests.request("POST", url, headers=headers, data=payload)
   
   print(response.text)
   

   Replace <ACCESS_TOKEN> with your actual access token from GetBlock.

5. Run the script:

   python main.py

Support & Resources

• Hyperliquid Documentation

• HyperEVM Developer Docs

• Block Explorer