eth_getBlockByNumber - Polygon

Example code for the eth_getBlockByNumber json-rpc method. Сomplete guide on how to use eth_getBlockByNumber json-rpc in GetBlock.io Web3 documentation.

The eth_getBlockByNumber method returns information about a block by its number. This is one of the most commonly used methods for retrieving block data.

Parameters

Parameter

Type

Required

Description

blockNumber

string

Yes

Block number in hex, or "latest", "earliest", "pending", "safe", "finalized"

fullTransactions

boolean

Yes

If true, returns full transaction objects; if false, returns only transaction hashes

Request Examples

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": ["latest", false],
    "id": "getblock.io"
}'

request.js

import axios from 'axios';

const url = 'https://go.getblock.io/<ACCESS-TOKEN>/';

const payload = {
    jsonrpc: '2.0',
    method: 'eth_getBlockByNumber',
    params: ["latest", false],
    id: 'getblock.io'
};

axios.post(url, payload, {
    headers: { 'Content-Type': 'application/json' }
})
.then(response => console.log(response.data))
.catch(error => console.error(error));

request.py

import requests

url = "https://go.getblock.io/<ACCESS-TOKEN>/"

payload = {
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": ["latest", false],
    "id": "getblock.io"
}

response = requests.post(url, headers={"Content-Type": "application/json"}, json=payload)
print(response.json())

main.rs

use reqwest::header;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
    
    let response = client
        .post("https://go.getblock.io/<ACCESS-TOKEN>/")
        .header(header::CONTENT_TYPE, "application/json")
        .body(r#"{
            "jsonrpc": "2.0",
            "method": "eth_getBlockByNumber",
            "params": ["latest", false],
            "id": "getblock.io"
        }"#)
        .send()
        .await?;
    
    println!("{}", response.text().await?);
    Ok(())
}

Response

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": {
        "number": "0x3A2B5C7",
        "hash": "0x...",
        "parentHash": "0x...",
        "timestamp": "0x64a2b5c7",
        "gasUsed": "0x1234",
        "gasLimit": "0x1c9c380",
        "transactions": []
    }
}

Response Parameters

Field

Type

Description

jsonrpc

string

JSON-RPC version (2.0)

string

Request identifier

result

varies

Block object with details or null if not found

Use Case

The eth_getBlockByNumber method is useful for:

Block scanning
Event indexing
Chain synchronization
Data extraction

Error Handling

Status Code

Error Message

Cause

403

Forbidden

Missing or invalid ACCESS-TOKEN

-32600

Invalid Request

Malformed request body

-32602

Invalid params

Invalid method parameters

Web3 Integration

ethers.js

import { ethers } from 'ethers';

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

const result = await provider.send('eth_getBlockByNumber', ["latest", false]);
console.log('Result:', result);

viem.js

import { createPublicClient, http } from 'viem';
import { polygon } from 'viem/chains';

const client = createPublicClient({
    chain: polygon,
    transport: http('https://go.getblock.io/<ACCESS-TOKEN>/')
});

const result = await client.request({
    method: 'eth_getBlockByNumber',
    params: ["latest", false]
});
console.log('Result:', result);

Previouseth_getBlockByHash - Polygon Nexteth_getBlockTransactionCountByHash - Polygon

Last updated 1 month ago

Was this helpful?

hashtagParameters

hashtagRequest Examples

hashtagResponse

hashtagResponse Parameters

hashtagUse Case

hashtagError Handling

hashtagWeb3 Integration

Parameters

Request Examples

Response

Response Parameters

Use Case

Error Handling

Web3 Integration