eth_getBlockByNumber

Network: Arbitrum One · Mainnet · Chain ID 42161 (0xa4b1)

Counts as 1 request. See Request Counting.

Returns information about a block by block number.

Parameters

QUANTITY|TAG — Integer of a block number, or the string "earliest", "latest", "safe", "finalized", or "pending".
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


{
  "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


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


const response = await fetch("https://arbitrum-one-rpc.blockreq.com/v1/rpc/public", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "latest",
    false
  ],
  "id": 1
}),
});
const data = await response.json();
console.log(data.result);


import requests

response = requests.post(
    "https://arbitrum-one-rpc.blockreq.com/v1/rpc/public",
    json={
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "latest",
    false
  ],
  "id": 1
}
)
print(response.json()["result"])


package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["latest",false],"id":1}`)
	resp, err := http.Post(
		"https://arbitrum-one-rpc.blockreq.com/v1/rpc/public",
		"application/json",
		bytes.NewBuffer(payload),
	)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	var result map[string]interface{}
	json.Unmarshal(body, &result)
	fmt.Println(result["result"])
}


import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://arbitrum-one-rpc.blockreq.com/v1/rpc/public"),
});

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


cast rpc --rpc-url https://arbitrum-one-rpc.blockreq.com/v1/rpc/public eth_getBlockByNumber latest false


const { ethers } = require("hardhat");

async function main() {
  const provider = new ethers.JsonRpcProvider("https://arbitrum-one-rpc.blockreq.com/v1/rpc/public");
  const result = await provider.send("eth_getBlockByNumber", ["latest",false]);
  console.log(result);
}

main();