Skip to main content
Ethereum API

eth_getBlockByNumber

Summary: Returns information about a block by number.

Parameters

Block oneOf

Block number or tag

Block number string

hex encoded unsigned integer

Block tag enum

earliest: The lowest numbered block the client has available; finalized: The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination; safe: The most recent block that is safe from re-orgs under honest majority and certain synchronicity assumptions; latest: The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions; pending: A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool. Before the merge transition is finalized, any call querying for finalized or safe block MUST be responded to with -39001: Unknown block error

Possible enum values
earliest
finalized
safe
latest
pending
Hydrated transactions boolean
required

hydrated

Returns

Block information oneOf

Not Found (null) null

Not Found (null)

Block object object
required

Block object

hash string

32 byte hex value

parentHash string

32 byte hex value

sha3Uncles string

32 byte hex value

miner string

hex encoded address

stateRoot string

32 byte hex value

transactionsRoot string

32 byte hex value

receiptsRoot string

32 byte hex value

logsBloom string

256 hex encoded bytes

difficulty string

hex encoded unsigned integer

number string

hex encoded unsigned integer

gasLimit string

hex encoded unsigned integer

gasUsed string

hex encoded unsigned integer

timestamp string

hex encoded unsigned integer

extraData string

hex encoded bytes

mixHash string

32 byte hex value

nonce string

8 hex encoded bytes

baseFeePerGas string

hex encoded unsigned integer

withdrawalsRoot string

32 byte hex value

blobGasUsed string

hex encoded unsigned integer

excessBlobGas string

hex encoded unsigned integer

parentBeaconBlockRoot string

32 byte hex value

size string

hex encoded unsigned integer

transactions anyOf

Transaction hashes array

Transaction hashes

32 byte hex value string

32 byte hex value

Full transactions array

Full transactions

Transaction information allOf

Transaction information

Contextual information
required

Contextual information

oneOf

Signed 4844 Transaction allOf

Signed 4844 Transaction

EIP-4844 transaction. object
required

EIP-4844 transaction.

type string

hex encoded byte

nonce string

hex encoded unsigned integer

to string

hex encoded address

gas string

hex encoded unsigned integer

value string

hex encoded unsigned integer

input string

hex encoded bytes

maxPriorityFeePerGas string

hex encoded unsigned integer

maxFeePerGas string

hex encoded unsigned integer

maxFeePerBlobGas string

hex encoded unsigned integer

accessList array

Access list

Access list entry object

Access list entry

address string

hex encoded address

storageKeys array

32 byte hex value string

32 byte hex value

blobVersionedHashes array

List of versioned blob hashes associated with the transaction's EIP-4844 data blobs.

32 byte hex value string

32 byte hex value

chainId string

hex encoded unsigned integer

EIP-4844 transaction signature properties.
required

EIP-4844 transaction signature properties.

Signed 1559 Transaction allOf

Signed 1559 Transaction

EIP-1559 transaction. object
required

EIP-1559 transaction.

type string

type

nonce string

hex encoded unsigned integer

to oneOf

to address

Contract Creation (null) null

Contract Creation (null)

Address string

hex encoded address

gas string

hex encoded unsigned integer

value string

hex encoded unsigned integer

input string

hex encoded bytes

maxPriorityFeePerGas string

hex encoded unsigned integer

maxFeePerGas string

hex encoded unsigned integer

gasPrice string

hex encoded unsigned integer

accessList array

Access list

Access list entry object

Access list entry

address string

hex encoded address

storageKeys array

32 byte hex value string

32 byte hex value

chainId string

hex encoded unsigned integer

EIP-1559 transaction signature properties.
required

EIP-1559 transaction signature properties.

Signed 2930 Transaction allOf

Signed 2930 Transaction

EIP-2930 transaction. object
required

EIP-2930 transaction.

type string

type

nonce string

hex encoded unsigned integer

to oneOf

to address

Contract Creation (null) null

Contract Creation (null)

Address string

hex encoded address

gas string

hex encoded unsigned integer

value string

hex encoded unsigned integer

input string

hex encoded bytes

gasPrice string

hex encoded unsigned integer

accessList array

Access list

Access list entry object

Access list entry

address string

hex encoded address

storageKeys array

32 byte hex value string

32 byte hex value

chainId string

hex encoded unsigned integer

EIP-2930 transaction signature properties.
required

EIP-2930 transaction signature properties.

Signed Legacy Transaction allOf

Signed Legacy Transaction

Legacy transaction. object
required

Legacy transaction.

type string

type

nonce string

hex encoded unsigned integer

to oneOf

to address

Contract Creation (null) null

Contract Creation (null)

Address string

hex encoded address

gas string

hex encoded unsigned integer

value string

hex encoded unsigned integer

input string

hex encoded bytes

gasPrice string

hex encoded unsigned integer

chainId string

hex encoded unsigned integer

Legacy transaction signature properties.
required

Legacy transaction signature properties.

withdrawals array

Withdrawals

Validator withdrawal object
required

Validator withdrawal

index string

hex encoded 64 bit unsigned integer

validatorIndex string

hex encoded 64 bit unsigned integer

address string

hex encoded address

amount string

hex encoded 256 bit unsigned integer

uncles array

Uncles

32 byte hex value string

32 byte hex value

Customize request
Connect your MetaMask wallet to run requests successfully.
Request
await window.ethereum.request({
 "method": "eth_getBlockByNumber",
 "params": [],
});