Skip to content
TraceFast Docs

One block

Open this block in TraceFast →

One Ethereum block by height: its header — hash, parent, roots, fee recipient, gas, base fee, blob gas — and the totals of what it contains: transactions by outcome, contract creations, blob transactions, logs, validator withdrawals, value moved, and the fees burnt and paid. New to blocks? See blocks on ethereum.org.

GET https://tracefast.xyz/api/v1/chains/1/blocks/{number}
ParameterInTypeNotes
numberpathintegerblock height, 0 or more

Access — an API key on the Enriched Data plan or higher (plans), or no key at all: pay per call with x402 at the same path on https://mpp.tracefast.xyz/api/v1, at the price its 402 states. As a tool for AI agents: get_block on the MCP server. Stable — see stability.

chains/1 is a literal: the method serves Ethereum mainnet data. Other chain ids answer 404 chain_not_supported. There are no query parameters — an unknown one is refused rather than ignored.

For the newest block without knowing its height, use the latest block: same body.

What it covers, and what it does not

  • Totals, not the rows themselves. The block's transactions are in transactions of one block, its withdrawals in validator withdrawals of one block, the accounts it changed in accounts touched by one block, and its EIP-7702 authorizations in authorizations of one block.
  • Some totals can be absent — never zero in their place. When a block's receipt totals are not available, successfulTxCount, failedTxCount and logCount are absent together; totalGasFees and totalTips likewise. A block that ran transactions never reports a zero fee.
  • The most recent blocks carry fewer fields. withdrawalCount is absent for the newest blocks — totalWithdrawalGwei is always there, so a positive total with no count means "count not stated", never "no withdrawals". uniqueAddressCount and blobBaseFeeWei can also be absent on the newest blocks. See the latest block for such a body.
  • Fork-dependent fields are absent before their fork: baseFeePerGas and burntFees before EIP-1559 (London), the blob fields before EIP-4844 (Cancun).

Response

200 application/json:

{
  "data": {
    "chainId": 1,
    "number": 25920000,
    "hash": "0x0695a76c1e24f2a9677f3c4cc4842b9b5a3f84d45863e9b9ef276fc48fd5874f",
    "parentHash": "0xb5c19b6d9972c3f6ab8ac760f811abac0aa93f76586b703996ff90267a469b32",
    "timestamp": 1788718079,
    "feeRecipient": "0x396343362be2a4da1ce0c1c210945346fb82aa49",
    "stateRoot": "0xd510406e8bfc7d3a7f8ab58867e9ffc3b217b1672490ff2a2cb47bce87b68aee",
    "transactionsRoot": "0xa63d26ae365594336c9746d228ce65df452a44bfd38480bcae2945b38c6fdd5a",
    "receiptsRoot": "0x940d72c1160bbe66d5d16afab9dca41f11bf164512348b3d200ca24c10a827a6",
    "gasLimit": "60000000",
    "gasUsed": "28602987",
    "baseFeePerGas": "92963002",
    "blobGasUsed": "1179648",
    "excessBlobGas": "182054093",
    "blobBaseFeeWei": "5842048",
    "txCount": 411,
    "successfulTxCount": 411,
    "failedTxCount": 0,
    "contractCreationCount": 0,
    "blobTxCount": 3,
    "logCount": 627,
    "withdrawalCount": 16,
    "totalWithdrawalGwei": "282325851",
    "totalValueWei": "3563845140607455473",
    "burntFees": "2659019537686974",
    "totalGasFees": "9107983437856784",
    "totalTips": "6448963900169810",
    "difficulty": "0",
    "extraData": "0xe29ca82051756173617220287175617361722e77696e2920e29ca8",
    "ommersCount": 0,
    "uniqueAddressCount": 690
  },
  "meta": {
    "chain": "ethereum",
    "timestamp": 1789063614426,
    "cached": false,
    "asOfBlock": 25920000,
    "docs": "https://docs.tracefast.xyz/api/block"
  }
}

Amounts — gas, wei, gwei — are decimal strings, because they can exceed what a JSON number holds exactly. Counts and heights are integers.

data — the header

FieldMeaning
chainId1, Ethereum mainnet
numberblock height
hashblock hash, lowercase
parentHashhash of the parent block
timestampUnix time of the block, seconds
feeRecipientthe address that received the block's priority fees (the header's beneficiary)
stateRootstate root after this block
transactionsRoot, receiptsRootthe header's transactions and receipts roots
gasLimit, gasUsedthe block's gas limit and the gas its transactions used
baseFeePerGasbase fee per gas, wei. Absent before EIP-1559
blobGasUsed, excessBlobGasEIP-4844 blob gas. Absent before Cancun
blobBaseFeeWeiblob base fee for this block, wei. Absent before Cancun, and can be absent on the newest blocks
difficultythe header's difficulty as a decimal string — "0" since the Merge
extraDatathe header's extra data, 0x-hex — often the builder's tag
ommersCountommers (uncles) — 0 since the Merge

data — the totals

FieldMeaning
txCounttransactions in the block
successfulTxCount, failedTxCounthow many succeeded and failed. Absent together with logCount when not computed
contractCreationCounttransactions that created a contract
blobTxCountEIP-4844 blob transactions
logCountreceipt logs across all transactions
withdrawalCountvalidator withdrawals in the block. Absent on the newest blocks while it cannot be stated — never 0 in its place
totalWithdrawalGweithe withdrawals' total, gwei. Always stated
totalValueWeisum of the transactions' value, wei
burntFeesbase fees burnt, wei. Absent before EIP-1559
totalGasFeestotal gas fees the transactions paid, wei
totalTipsthe part of totalGasFees that went to the fee recipient as tips, wei. Absent together with totalGasFees
uniqueAddressCountdistinct addresses whose state the block touched. Absent while still being counted

meta is the same on every method — see conventions. Here meta.asOfBlock equals number.

Errors

StatuscodeWhendetails
400bad_requestnumber is not a non-negative integerreason: block_number_invalid
404not_foundno block at that height yet — past the newest block the API serves—
422block_not_availablethe block exists on chain but sits in a coverage gap; ask again laterreason: coverage_gap, coverageGapFromBlock, coverageGapToBlock, maxAvailableBlock

Malformed input, unknown parameters and the key check's 401/403/429 are the same for every method — see conventions and API keys.


Last updated 22 Oct 2026, 08:06 UTC · verified against TraceFast v1.0.261 · Markdown