eth_getBlockByNumber RPC Method

Parameters

blockNumber/tag

string

REQUIRED

The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized

transaction detail flag

boolean

REQUIRED

The method returns the full transaction objects when this value is true otherwise, it returns only the hashes of the transactions

Returns

object

object

A block object, or null when no block was found:

baseFeePerGas

string

Base fee per gas in this block, encoded as hexadecimal

blobGasUsed

string

Total blob gas used in the block, encoded as hexadecimal

difficulty

string

The integer of the difficulty for this block encoded as a hexadecimal

excessBlobGas

string

Excess blob gas carried over from the previous block, encoded as hexadecimal

extraData

string

The extra data field of this block

gasLimit

string

The maximum gas allowed in this block encoded as a hexadecimal

gasUsed

string

The total used gas by all transactions in this block encoded as a hexadecimal

hash

string

The block hash of the requested block. null if pending

logsBloom

string

The bloom filter for the logs of the block. null if pending

miner

string

The address of the beneficiary to whom the mining rewards were given

mixHash

string

A string of a 256-bit hash encoded as a hexadecimal

nonce

string

The hash of the generated proof-of-work. null if pending

number

string

The block number of the requested block encoded as a hexadecimal. null if pending

parentBeaconBlockRoot

string

Root of the corresponding beacon block in the consensus layer

parentHash

string

The hash of the parent block

receiptsRoot

string

The root of the receipts trie of the block

requestsHash

string

The hash of the requests made in this block, if applicable

sha3Uncles

string

The SHA3 of the uncles data in the block

size

string

The size of this block in bytes as an Integer value encoded as hexadecimal

stateRoot

string

The root of the final state trie of the block

timestamp

string

The unix timestamp for when the block was collated

transactions

array

An array of transaction objects or hashes included in the block

transactionsRoot

string

The root of the transaction trie of the block

uncles

array

An array of uncle hashes

withdrawals

array

Array of withdrawal operations included in the block

address

string

Address to which the withdrawal is made

amount

string

Amount withdrawn in Gwei, encoded as hexadecimal

index

string

Withdrawal index, encoded as hexadecimal

validatorIndex

string

Index of the validator making the withdrawal, encoded as hexadecimal

withdrawalsRoot

string

The root of the withdrawals in the block

Request

curl https://docs-demo.0g-galileo.quiknode.pro/ \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_getBlockByNumber","params":["0xcedca",false],"id":1,"jsonrpc":"2.0"}'

require 'eth'

client = Eth::Client.create 'https://docs-demo.0g-galileo.quiknode.pro/'
payload = {
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": ["0xcedca",false],
    "id": "1"
}

response = client.send(payload.to_json)
puts response

import { ethers } from "ethers";
(async () => {
  const provider = new ethers.JsonRpcProvider("https://docs-demo.0g-galileo.quiknode.pro/");
  const blockData = await provider.getBlock(
    "0xcedca",
    false
  );
  console.log(blockData);
})();

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "method": "eth_getBlockByNumber",
  "params": [
    "0xcedca",
    false
  ],
  "id": 1,
  "jsonrpc": "2.0"
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://docs-demo.0g-galileo.quiknode.pro/", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import requests
import json

url = "https://docs-demo.0g-galileo.quiknode.pro/"

payload = json.dumps({
  "method": "eth_getBlockByNumber",
  "params": [
    "0xcedca",
    False
  ],
  "id": 1,
  "jsonrpc": "2.0"
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

require "uri"
require "json"
require "net/http"

url = URI("https://docs-demo.0g-galileo.quiknode.pro/")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "method": "eth_getBlockByNumber",
  "params": [
    "0xcedca",
    false
  ],
  "id": 1,
  "jsonrpc": "2.0"
})

response = https.request(request)
puts response.read_body

from web3 import Web3, HTTPProvider
from web3.middleware import geth_poa_middleware
w3 = Web3(HTTPProvider('https://docs-demo.0g-galileo.quiknode.pro/'))
w3.middleware_onion.inject(geth_poa_middleware, layer=0)
print(w3.eth.get_block('0xcedca',False))

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free