Unichain

GetBlock provides fast and reliable access to Unichain nodes via JSON-RPC API. Connect to the Unichain network without running your own infrastructure.

Unichain is an Ethereum Layer 2 built by Uniswap Labs on the OP Stack, part of the Optimism Superchain. It is EVM-equivalent, uses ETH for gas, and settles to Ethereum Layer 1, so existing Ethereum contracts and tooling — Hardhat, Foundry, ethers.js, viem, and web3.py — run without modification. Unichain is purpose-built for onchain markets, with fast block times and native support for Uniswap v4.

Because Unichain is an OP Stack rollup, it inherits Ethereum security and exposes the standard Ethereum JSON-RPC method set. This documentation targets Unichain Mainnet (Chain ID 130).

Key Features

• Full EVM Equivalence (OP Stack): Runs standard EVM bytecode; deploy Solidity contracts and use Hardhat, Foundry, ethers.js, viem, and web3.py without modification

• Optimism Superchain: A Superchain member that shares bridging, tooling, and security standards across OP Stack chains

• Ethereum Security: Settles to Ethereum L1 and inherits its security guarantees, with a permissionless fault-proof system

• ETH for Gas: Transaction fees are paid in ETH, the same asset as Ethereum mainnet

• Fast Block Times: Roughly 1-second blocks, with sub-block previews for responsive user experiences

• Native Uniswap Integration: Built for onchain markets, with first-class support for Uniswap v4 and its hooks

• MEV Awareness: Designed with mechanisms that reduce harmful MEV for traders

• Standard Ethereum JSON-RPC: The full eth_*, debug_*, net_*, and web3_* method set

TECHNICAL DISCLAIMER: AUTHORITATIVE JSON-RPC SPECIFICATION

GetBlock's Unichain API reference documentation is provided exclusively for informational purposes and to optimize the developer experience. The canonical and normative specification for the Ethereum JSON-RPC API is maintained by the Ethereum community and published at ethereum.org/en/developers/docs/apis/json-rpc/. For Unichain-specific protocol details, consult the official documentation at docs.unichain.org.

Network Information

Property	Value
Network Name	Unichain Mainnet
Stage	Mainnet (live)
Chain ID	130 (0x82)
Native Currency	ETH
Decimals	18
Layer	Layer 2 (OP Stack rollup on Ethereum)
Superchain	Optimism Superchain member
Smart Contract VM	EVM (EVM-equivalent)
Address Format	Ethereum-style (0x…, 20 bytes)
Block Explorer	uniscan.xyz
Testnet	Unichain Sepolia (Chain ID 1301)

Base URL

Frankfurt, Germany

https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

New York, USA

https://shared.us-east-1.getblock.io/<ACCESS_TOKEN>

Singapore, Singapore

https://shared.ap-southeast-1.getblock.io/<ACCESS_TOKEN>

All Unichain JSON-RPC methods are called by sending a POST request to the base URL with a standard JSON-RPC 2.0 body. For a WebSocket connection, use the WebSocket scheme: wss://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/.

Supported Networks

Network	JSON-RPC	WSS	MEV-Protected(WSS)	Frankfurt, Germany	New York, USA	Singapore, Singapore
Mainnet	✅	✅	✅	✅	✅	✅

Unichain Sepolia (Chain ID 1301) is the test environment for staging contracts before mainnet. Confirm testnet endpoint availability from the GetBlock dashboard.

Quickstart

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

• Axios (JavaScript / Node.js)

• Python (Requests library)

Before you begin, you must have already installed npm or yarn on your local machine (for the Axios example) or Python and pip (for the Python example).

JavaScript (Axios)

1

Setup project

Create and initialize a new project:

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

2

Install Axios

npm install axios

3

Create file

Create a new file named index.js. This is where you will make your first call.

4

Set ES module type

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

5

Add code

Add the following code to index.js:

index.js

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "eth_chainId",
    "params": [],
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data, null, 2)))
    .catch(error => console.log(error));

Replace <ACCESS-TOKEN> with your actual access token from GetBlock.

6

Run the script

node index.js

Expected output:

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

The result field is the Unichain Mainnet chain ID (0x82 = 130 in decimal). This confirms you are connected to the correct network.

Python (Requests)

1

Setup the project directory

mkdir unichain-api-quickstart
cd unichain-api-quickstart

2

Create and activate a virtual environment

python -m venv venv
source venv/bin/activate

# On Windows, use venv\Scripts\activate

3

Install requests

pip install requests

4

Create script

Create a file called main.py with the following content:

main.py

import requests
import json

url = "https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "eth_chainId",
    "params": [],
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.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

Available API Methods

Unichain exposes the standard Ethereum JSON-RPC method set. All methods are POST-only and called against the base URL above.

Block & Chain Information

Method	Description
eth_blockNumber	Returns the current latest block number
eth_chainId	Returns the chain ID (0x82 = 130 for Unichain Mainnet)
eth_getBlockByNumber	Returns block information by block number
eth_getBlockByHash	Returns block information by block hash
eth_getBlockTransactionCountByNumber	Returns the number of transactions in a block by block number
eth_getBlockTransactionCountByHash	Returns the number of transactions in a block by block hash
eth_getBlockReceipts	Returns all transaction receipts for a given block
eth_syncing	Returns sync status or false if the node is fully synced

Account & State

Method	Description
eth_getBalance	Returns the native ETH balance of an account (in wei)
eth_getCode	Returns the contract bytecode at a given address
eth_getStorageAt	Returns the value at a specific storage slot
eth_getTransactionCount	Returns the transaction count (nonce) for an account

Transactions

Method	Description
eth_sendRawTransaction	Broadcasts a signed transaction
eth_getTransactionByHash	Returns a transaction by its hash
eth_getTransactionByBlockHashAndIndex	Returns a transaction by block hash and index
eth_getTransactionByBlockNumberAndIndex	Returns a transaction by block number and index
eth_getTransactionReceipt	Returns the receipt for a transaction by hash
eth_call	Executes a read-only call against contract state
eth_estimateGas	Estimates gas required for a transaction

Gas & Fee Market

Method	Description
eth_gasPrice	Returns the current gas price in wei
eth_maxPriorityFeePerGas	Returns the suggested max priority fee per gas (EIP-1559)
eth_feeHistory	Returns historical base fees and priority fees

Logs

Method	Description
eth_getLogs	Returns logs matching a given filter

Debug & Trace

Method	Description
debug_traceTransaction	Replays a transaction and returns an execution trace
debug_traceBlockByNumber	Traces every transaction in a block by block number
debug_traceBlockByHash	Traces every transaction in a block by block hash

Network & Client Info

Method	Description
net_version	Returns the network ID (130 for Unichain Mainnet)
web3_clientVersion	Returns the client software version

Support

For technical support and questions:

• Support Email: [e-mail]

See Also

• Official Unichain Documentation

• Unichain Homepage

• Ethereum JSON-RPC Specification

• Unichain Block Explorer (Uniscan)

• Unichain on Chainlist

• Ethers.js Documentation

• Viem Documentation