Skip to main content
Returns information about a block by its number.
Flashblocks: Query https://mainnet-preconf.base.org with "pending" to fetch the live Flashblock in progress — a real block object updated every ~200ms with new pre-confirmed transactions. The response shape is identical; the block is simply not yet sealed.

Parameters

block
string
required
Block number in hex, or "latest", "pending", "safe", "finalized", "earliest". Use "pending" on a Flashblocks endpoint to get the in-progress block.
fullTransactions
boolean
required
If true, returns full transaction objects. If false, returns only transaction hashes.

Returns

result
object
A block object, or null if no block was found.

Flashblock-Specific Response Fields

When querying "pending" on a Flashblocks endpoint, the response is a live snapshot of the block being built. A few fields behave differently:
FieldStandard latestFlashblocks pending
numberSealed block numberCurrent block number (being built)
hashFinal block hashHash of the partial block at this Flashblock index
gasUsedFinal gas usedCumulative gas used up to this Flashblock
transactionsAll sealed transactionsTransactions pre-confirmed so far
blobGasUsedFinal blob gas usedPropagated from cumulative Flashblock state

Example

curl https://mainnet.base.org \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": ["latest", false],
    "id": 1
  }'