eth_getBlockTransactionCountByNumber

curl --request POST \
  --url https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3 \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByNumber",
  "params": [
    "0x1F37730"
  ]
}
'

import requests

url = "https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3"

payload = {
    "id": 1,
    "jsonrpc": "2.0",
    "method": "eth_getBlockTransactionCountByNumber",
    "params": ["0x1F37730"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    id: 1,
    jsonrpc: '2.0',
    method: 'eth_getBlockTransactionCountByNumber',
    params: ['0x1F37730']
  })
};

fetch('https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 1,
    'jsonrpc' => '2.0',
    'method' => 'eth_getBlockTransactionCountByNumber',
    'params' => [
        '0x1F37730'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3"

	payload := strings.NewReader("{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_getBlockTransactionCountByNumber\",\n  \"params\": [\n    \"0x1F37730\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3")
  .header("Content-Type", "application/json")
  .body("{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_getBlockTransactionCountByNumber\",\n  \"params\": [\n    \"0x1F37730\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_getBlockTransactionCountByNumber\",\n  \"params\": [\n    \"0x1F37730\"\n  ]\n}"

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

{
  "jsonrpc": "<string>",
  "id": 123,
  "result": "<string>"
}

POST

a9bca2f0f84b54086ceebe590316fff3

eth_getBlockTransactionCountByNumber

curl --request POST \
  --url https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3 \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByNumber",
  "params": [
    "0x1F37730"
  ]
}
'

import requests

url = "https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3"

payload = {
    "id": 1,
    "jsonrpc": "2.0",
    "method": "eth_getBlockTransactionCountByNumber",
    "params": ["0x1F37730"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    id: 1,
    jsonrpc: '2.0',
    method: 'eth_getBlockTransactionCountByNumber',
    params: ['0x1F37730']
  })
};

fetch('https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => 1,
    'jsonrpc' => '2.0',
    'method' => 'eth_getBlockTransactionCountByNumber',
    'params' => [
        '0x1F37730'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3"

	payload := strings.NewReader("{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_getBlockTransactionCountByNumber\",\n  \"params\": [\n    \"0x1F37730\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3")
  .header("Content-Type", "application/json")
  .body("{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_getBlockTransactionCountByNumber\",\n  \"params\": [\n    \"0x1F37730\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://nd-828-700-214.p2pify.com/a9bca2f0f84b54086ceebe590316fff3")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"id\": 1,\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"eth_getBlockTransactionCountByNumber\",\n  \"params\": [\n    \"0x1F37730\"\n  ]\n}"

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

{
  "jsonrpc": "<string>",
  "id": 123,
  "result": "<string>"
}

Polygon API method that returns the number of transactions in a block specified by block number or tag. This information can be useful for analytics purposes.

Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

quantity or tag — the integer of a block encoded as hexadecimal or the string with:
- latest — the most recent block in the blockchain and the current state of the blockchain at the most recent block
- earliest — the earliest available or genesis block
- pending — the pending state and transactions block. The current state of transactions that have been broadcast to the network but have not yet been included in a block.

See the default block parameter.

Response

quantity — an integer value representing how many transactions are included in the block.

`eth_getBlockTransactionCountByNumber` code examples

const ethers = require('ethers');
const NODE_URL = "CHAINSTACK_NODE_URL";
const provider = new ethers.JsonRpcProvider(NODE_URL);

const getTransactionsCount = async (blockId) => {
    const count = await provider.send("eth_getBlockTransactionCountByNumber", [blockId]);
     console.log(count);
   };

   getTransactionsCount('latest')

from web3 import Web3  
node_url = "CHAINSTACK_NODE_URL" 

web3 = Web3(Web3.HTTPProvider(node_url)) 
print (web3.eth.get_block_transaction_count(32732976)) # A hex value starting with "0x" is accepted as well.

Use case

eth_getBlockTransactionCountByNumber can be used to analyze how many transactions are included on the Polygon blockchain in a certain period. For instance, on average, a new block is generated on the Polygon mainnet every 2.1 seconds, resulting in approximately 1,700 blocks per hour. Using the ethers.js library, one can inspect the past 1,700 blocks starting from the latest block and use eth_getBlockTransactionCountByNumber to find the number of transactions in each block to sum them.

index.js

const ethers = require('ethers');
const NODE_URL = "CHAINSTACK_NODE_URL";
const provider = new ethers.JsonRpcProvider(NODE_URL);

async function retrieveTransactionCounts() {
    // Get the current block number
    const currentBlockNumber = await provider.getBlockNumber();
  
    // Calculate the block number from one hour ago
    const oneHourAgoBlockNumber = currentBlockNumber - 1700; // 1700/blocks/hr on average on the Polygon mainnet
  
    // Initialize a variable to store the total number of transactions
    let totalTransactionCount = 0;
  
    // Loop through all blocks from the current block number to the block number from one hour ago
    for (let block = currentBlockNumber; block > oneHourAgoBlockNumber; block--) {
  
      // Get the number of transactions in this block
      const transactionCount = await provider.send("eth_getBlockTransactionCountByNumber", [block]);

      // Make the necessery conversions from hex to decimal
      const stringCount = BigInt(transactionCount).toString();
      const decimalCount = Number(stringCount)

      // Add the number of transactions in this block to the total
      totalTransactionCount += decimalCount;

      const stringBlock = BigInt(block).toString();
      const decimalBlock = Number(stringBlock)
      console.log(`Block ${decimalBlock} has ${decimalCount} transactions.`);
    }
  
    console.log(`The total number of transactions in the previous hour is: ${totalTransactionCount}`);
  }
  
  retrieveTransactionCounts();

Using eth_getBlockTransactionCountByNumber is a bit more straightforward compared to the example shown using eth_getBlockTransactionCountByHash for this same use case, you don’t need to extract the block hash; instead, you can query the transaction count directly. This example is made using the ethers.js library, and you can notice that it requires more parsing compared to web3.js, and the results are given as hexadecimal.

Body

application/json

integer

default:1

jsonrpc

string

default:2.0

method

string

default:eth_getBlockTransactionCountByNumber

params

string[]

The block number.

Response

200 - application/json

The block transaction count information

jsonrpc

string

integer

result

string

Last modified on June 25, 2026

eth_getBlockTransactionCountByHash | Polygon eth_getBlockByNumber | Polygon

​Parameters

​Response

​eth_getBlockTransactionCountByNumber code examples

​Use case

Body

Response

Parameters

Response

`eth_getBlockTransactionCountByNumber` code examples

Use case