pulsechain.box
eth

eth_getBlockByNumber

Returns information about a block by its block number.

Returns information about a block by its block number.

Parameters

#TypeDescription
1stringBlock number as a hex string, or a block tag ("latest", "earliest", "pending").
2boolIf true, returns full transaction objects; if false, returns only transaction hashes.

Returns

object | null -- A block object, or null if no block was found. The object contains:

FieldTypeDescription
numberstringBlock number (hex)
hashstringBlock hash (32 bytes)
parentHashstringHash of the parent block
noncestringAlways "0x0000000000000000" on PoS
sha3UnclesstringSHA3 of the uncles data
logsBloomstringBloom filter for the logs (256 bytes)
transactionsRootstringRoot of the transaction trie
stateRootstringRoot of the state trie
receiptsRootstringRoot of the receipts trie
minerstringAddress of the block proposer
difficultystringAlways "0x0" on PoS
totalDifficultystringCumulative difficulty
extraDatastringExtra data field
sizestringBlock size in bytes (hex)
gasLimitstringMaximum gas allowed in the block (hex)
gasUsedstringTotal gas used by all transactions (hex)
timestampstringUnix timestamp of the block (hex)
transactionsarrayTransaction hashes or full transaction objects
unclesarrayAlways empty on PoS
baseFeePerGasstringBase fee per gas (EIP-1559, hex)

Example

curl -s -X POST https://rpc.pulsechain.box \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": ["0x100000", false],
    "id": 1
  }'
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x100000",
    "hash": "0x...",
    "parentHash": "0x...",
    "timestamp": "0x...",
    "gasLimit": "0x1c9c380",
    "gasUsed": "0x...",
    "miner": "0x...",
    "baseFeePerGas": "0x...",
    "transactions": [],
    "..."
  }
}
TRY IT

Notes

  • Set the second parameter to false to return only transaction hashes, which is significantly faster and uses less bandwidth for blocks with many transactions.
  • Set it to true to get full transaction objects including from, to, value, input, gas, etc.
  • Returns null for block numbers that do not exist yet.
  • The block tag "latest" returns the most recently mined block, "earliest" returns the genesis block (block 0), and "pending" returns the pending block being assembled.
  • Block 0x100000 (1,048,576 in decimal) is used in the example as a known historical block on PulseChain.
Copyright © 2026 AvecdrA. Made with love.