Docs
Supported ChainsopBNBJSON-RPC APIBlock Methods

eth_getBlockReceipts - opBNB RPC Method

Return every transaction receipt in a block on opBNB. Useful for indexers, analytics pipelines, and event backfills across fully on-chain games, high-frequency DeFi, and cost-sensitive applications on BNB Chain.

Returns all transaction receipts for a block on opBNB. This is more efficient than calling eth_getTransactionReceipt once per transaction when you already know the target block.

Why opBNB? Build on Binance's high-performance L2 processing 100M+ daily transactions with the lowest L2 gas fees with sub-$0.0001 gas fees, 5-10K TPS, sub-second block times via Volta/Maxwell upgrades, and OP Stack architecture.

When to Use This Method

eth_getBlockReceipts is useful for GameFi developers, high-frequency dApp builders, and teams requiring BNB Chain integration:

  • Indexer Backfills — Pull every receipt in a block with one request instead of looping over transaction hashes
  • Event Collection — Scan all logs emitted by a block when building analytics or data pipelines
  • Settlement Auditing — Verify every transaction outcome in a target block for fully on-chain games, high-frequency DeFi, and cost-sensitive applications on BNB Chain
  • Operational Debugging — Compare receipt-level gas usage, status, and logs across multiple transactions at once

Request Parameters

Request
blockQUANTITY | TAG | DATA

Block number, block tag such as latest, or 32-byte block hash

Response Body

Response
resultArray<Object> | null

Array of receipt objects for the block, or null if the block is not found

transactionHashDATA

Transaction hash

statusQUANTITY

0x1 on success, 0x0 on failure

gasUsedQUANTITY

Gas used by this transaction

cumulativeGasUsedQUANTITY

Total gas used in the block up to this transaction

logsArray<Object>

Logs emitted by the transaction

contractAddressDATA | null

Created contract address for deployment transactions

effectiveGasPriceQUANTITY

Effective gas price paid by the sender

Code Examples

Bash
curl -X POST https://api-opbnb-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockReceipts",
    "params": ["0x95db196d5589ba674d0397bf718f513e7d0e8509ba6829bd3e4435b87562e286"],
    "id": 1
  }'

Error Handling

Error CodeMessageDescription
-32602Invalid paramsThe block identifier is malformed
-32000Header not foundThe referenced block does not exist on the node