BNB Smart Chain

BNB Smart Chain

eth_getBlockTransactionCountByNumber

eth_getBlockTransactionCountByNumber answers a narrow question cheaply: how many transactions sit in the block at a given height or named tag? BNB Smart Chain finalizes new blocks about every three seconds under PoSA and pays its fees in BNB. You pass either a hex block number or a label like latest, safe, or finalized, and receive the count as a hex integer without downloading the full block body. Send the request to https://bsc.therpc.io/YOUR_API_KEY on chain ID 56 whenever you want block fullness but not the transactions themselves.

Use cases

• Gauge live BSC congestion by polling the latest block and watching how its transaction count rises and falls.
• Accumulate a per-block fullness time series that feeds gas-price and fee-estimation heuristics for your wallet.
• Scan a range of heights to flag near-empty blocks or unusually packed ones during validator-performance analysis.

Parameters

Response

Example request

1curl https://bsc.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "eth_getBlockTransactionCountByNumber",
7    "params": ["latest"],
8    "id": 1
9  }'

Try it live in the BNB Smart Chain playground.

Errors & troubleshooting

Common pitfalls

• Asking with the pending tag counts transactions the node is currently queuing for the next BSC block, so the figure can shift from one call to the next.
• The value comes back as a hex string such as 0x9c; run it through parseInt(value, 16) before doing any numeric comparison or arithmetic.

Supported networks

• Mainnet — Chain ID: 56
• Testnet — Chain ID: 97

See also

• eth_getBlockTransactionCountByHash
• eth_blockNumber
• eth_getBlockByNumber
• eth_getTransactionByBlockNumberAndIndex

1curl https://bsc.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBlockTransactionCountByNumber","params":[""]}'