{"uid":"cap_Vt0pD8E-Cf7ur4umPu2fG","slug":"evm-block-header-by-number-with-age-and-gas-utilisation-cf6ee46c","name":"EVM Block Header by Number with Age and Gas Utilisation","description":"Block header by number, with age and gas utilisation worked out — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/evm-block?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"block":{"type":"string"},"chain":{"enum":["ethereum","base","polygon","arbitrum","optimism","bsc","avalanche","gnosis","linea","scroll"],"type":"string"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"evm-block","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.003,"receipt_id":"g402-<16hex>"},"generated_at":"<iso8601>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4jKuROvML0LFFGAgA4r_3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a parsed EVM block header for a given block number and chain, including computed block age and gas utilisation percentage.","exampleAgentPrompt":"Can you fetch the block header for block 21000000 on Ethereum and tell me how old it is and what the gas utilisation was?","exampleUseCases":[{"title":"Gas utilisation audit for a specific block","prompt":"What was the gas utilisation percentage for block 20500000 on Base? I want to know how congested the network was at that point."},{"title":"Block age verification for a past event","prompt":"I need to know how old block 19000000 on Arbitrum is — can you pull the block header and tell me when it was mined?"},{"title":"Multi-chain block header comparison","prompt":"Can you grab the block header and gas utilisation for block 5000000 on Polygon so I can compare network conditions across chains?"}],"resultDescription":"A JSON object containing the block header fields for the requested block on the specified EVM chain, including computed block age (how long ago it was mined) and gas utilisation (gas used divided by gas limit as a percentage), along with a payment receipt containing transaction hash, amount paid in USD, and a receipt ID.","failureModes":["Invalid or non-existent block number returns an error response","Unsupported chain name outside the allowed enum returns a validation error","Payment failure via x402 protocol results in 402 response with no data","Network timeout if the target EVM RPC is slow or unavailable","Block number in the future returns an error or empty result"],"whenToPreferThis":"Use this endpoint when you need structured, pre-computed block metadata — specifically block age and gas utilisation — without having to manually calculate these from raw RPC data. It supports 10 major EVM chains in a single unified API, making it preferable over direct RPC calls when you need normalised output across chains or when you lack direct RPC access. Prefer this over raw eth_getBlockByNumber calls when gas utilisation and block age computations are needed out of the box.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:46.410Z","isFirstParty":false,"canonicalSlug":"evm-block-header-by-number-with-age-and-gas-utilisation-cf6ee46c"}