eth_getBlockByNumber

Returns information about a block by block number.

Parameters

1. QUANTITY|TAG — Integer of a block number, or the string "earliest", "latest", "safe", "finalized", or "pending".
2. Boolean — If true, returns full transaction objects; if false, returns only transaction hashes.

Returns

Object|null — A block object, or null when no block was found.

Field	Type	Description
number	QUANTITY	Block number
hash	DATA	Block hash
parentHash	DATA	Parent block hash
timestamp	QUANTITY	Unix timestamp
gasUsed	QUANTITY	Gas used
gasLimit	QUANTITY	Gas limit
baseFeePerGas	QUANTITY	Base fee (EIP-1559)
transactions	Array	Transaction hashes or objects

Request

curl -X POST https://eth-mainnet.blockreq.com/v1/rpc/public \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": ["latest", false],
    "id": 1
  }'

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x134e82a",
    "hash": "0xabc...def",
    "parentHash": "0x123...456",
    "timestamp": "0x65a1b2c3",
    "gasUsed": "0x1234",
    "gasLimit": "0x1c9c380",
    "baseFeePerGas": "0x3b9aca00",
    "transactions": ["0x..."]
  }
}

Code Examples

JavaScript (ethers.js v6)

import { JsonRpcProvider } from "ethers";
const provider = new JsonRpcProvider("https://eth-mainnet.blockreq.com/v1/rpc/YOUR_API_KEY");
const block = await provider.getBlock("latest");
console.log("Block:", block.number, "Txs:", block.transactions.length);

Python (web3.py)

from web3 import Web3
w3 = Web3(Web3.HTTPProvider("https://eth-mainnet.blockreq.com/v1/rpc/YOUR_API_KEY"))
block = w3.eth.get_block("latest")
print(f"Block {block.number} — {len(block.transactions)} txs")

RU Cost

Method	Cost
eth_getBlockByNumber	10 RU