eth_getblockbynumber - Worldchain

Example code for the eth_getBlockByNumber JSON-RPC method. Complete guide on how to use eth_getBlockByNumber JSON-RPC in GetBlock Web3 documentation.

Returns information about a block by block number on the World Chain network.

Parameters

Parameter	Type	Description
blockNumber	string	Block number in hex, or "latest", "earliest", "pending"
fullTransactions	boolean	If true, returns full transaction objects; if false, returns transaction hashes

Request

curl

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": ["0x1A5C3B2", false],
    "id": "getblock.io"
}'

JavaScript (axios)

Python (requests)

Rust (reqwest)

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": {
        "number": "0x1A5C3B2",
        "hash": "0x...",
        "parentHash": "0x...",
        "timestamp": "0x...",
        "transactions": [...]
    }
}

Response Parameters

Field	Type	Description
number	string	Block number in hex
hash	string	Block hash
parentHash	string	Hash of the parent block
timestamp	string	Block timestamp
transactions	array	Array of transaction objects or hashes

Use Case

The eth_getBlockByNumber method on World Chain is typically used for:

• Block data retrieval

• Historical data analysis

• Block exploration

• Chain indexing

Error Handling

Status Code	Error Message	Cause
403	Forbidden	Missing or invalid ACCESS-TOKEN

Web3 Integration

Ethers.js

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://go.getblock.io/<ACCESS-TOKEN>/');

const block = await provider.getBlock('latest');
console.log('Block:', block);

Viem