Ronin (RON)

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

Ronin is an EVM-compatible Layer 1 blockchain built by Sky Mavis, purpose-built for Web3 gaming. It is the chain behind Axie Infinity and Pixels, tuned for high-throughput, low-fee onchain gameplay with fast finality. Ronin is EVM-compatible, so Ethereum contracts and tooling — Hardhat, Foundry, ethers.js, viem, and web3.py — run without modification. The native token RON is used for gas, staking, and governance.

Ronin secures the chain with a Delegated Proof of Stake (DPoS) consensus operated by a validator set, targeting roughly 3-second blocks and sub-cent fees. This documentation targets Ronin Mainnet (Chain ID 2020).

Key Features

• Gaming-First Layer 1: Purpose-built by Sky Mavis for Web3 games such as Axie Infinity and Pixels

• Full EVM Compatibility: Standard Ethereum JSON-RPC method set; deploy Solidity contracts and use Hardhat, Foundry, ethers.js, viem, and web3.py without modification

• Delegated Proof of Stake: A validator set secures the chain with fast finality and roughly 3-second blocks

• Low Fees, High Throughput: Sub-cent fees and hundreds of transactions per second for microtransactions

• RON Native Token: RON pays gas and is used for staking and governance; WRON is the wrapped ERC-20 form

• Ronin Bridge: Moves assets between Ronin and Ethereum

• Katana DEX and NFT Ecosystem: A native DeFi and NFT ecosystem around the games it hosts

TECHNICAL DISCLAIMER: AUTHORITATIVE JSON-RPC SPECIFICATION

GetBlock's Ronin 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 Ronin-specific protocol details, consult the official documentation at docs.roninchain.com.

Ronin wallets and explorers commonly display addresses with a ronin: prefix instead of 0x (for example, ronin:e514... is the same address as 0xe514...). The JSON-RPC API uses the standard 0x hex form; convert ronin: addresses to 0x before sending them in requests.

Network Information

Property	Value
Network Name	Ronin Mainnet
Stage	Mainnet (live)
Chain ID	2020 (0x7e4)
Native Currency	RON
Decimals	18
Consensus	Delegated Proof of Stake (DPoS)
Smart Contract VM	EVM (EVM-compatible)
Address Format	Ethereum-style (0x…); often shown with a ronin: prefix
Block Explorer	app.roninchain.com/explorer
Testnet	Saigon Testnet (Chain ID 202601)

Base URL

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

All Ronin 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	Frankfurt, Germany	New York, USA	Singapore, Singapore
Mainnet	✅	✅	✅	✅	✅
Testnet	✅	✅	✅	✅	✅

Saigon Testnet (Chain ID 202601) 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 ronin-api-quickstart
cd ronin-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",
    "result": "0x7e4",
    "id": "getblock.io"
}

The result field is the Ronin Mainnet chain ID (0x7e4 = 2020 in decimal). This confirms you are connected to the correct network.

Python (Requests)

1

Setup the project directory

mkdir ronin-api-quickstart
cd ronin-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

Ronin 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 (0x7e4 = 2020 for Ronin 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 RON 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 (2020 for Ronin Mainnet)
web3_clientVersion	Returns the client software version

Support

For technical support and questions:

• Support Email: [e-mail]

See Also

• Official Ronin Documentation

• Ronin Homepage

• Ethereum JSON-RPC Specification

• Ronin Block Explorer

• Ronin on Chainlist

• Ethers.js Documentation

• Viem Documentation