{"uid":"cap_1aDlYtruTc70HCTFEZ-yl","slug":"evm-block-header-by-block-hash-382b13ef","name":"EVM Block Header by Block Hash","description":"Block header by block hash — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/evm-block-by-hash?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"chain":{"enum":["ethereum","base","polygon","arbitrum","optimism","bsc","avalanche","gnosis","linea","scroll"],"type":"string"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"evm-block-by-hash","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_Pv3KcKiYAW6WZPoKj3t60","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":"Retrieves the block header for a specific EVM block identified by its 32-byte hash, across ten supported EVM-compatible chains.","exampleAgentPrompt":"Can you fetch the block header for block hash 0x3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b on Ethereum?","exampleUseCases":[{"title":"Confirm block finality on Base","prompt":"I need to verify the block header for hash 0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b on Base — can you pull that block's details for me?"},{"title":"Audit historical block on Arbitrum","prompt":"We're auditing a transaction and need the full block header for block hash 0xaabbccddeeff00112233445566778899aabbccddeeff00112233445566778899aa on Arbitrum — please retrieve it."},{"title":"Cross-chain block timestamp lookup","prompt":"What was the timestamp and miner of the block with hash 0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef01 on Polygon?"}],"resultDescription":"Returns a JSON object confirming success, the endpoint type, and a payment receipt (including tx_hash, amount_usd, and receipt_id), along with a generated_at ISO8601 timestamp. The actual block header fields (number, timestamp, miner, gas, parent hash, etc.) are returned as part of the response payload.","failureModes":["Invalid block hash format (not a 64-char hex with 0x prefix) — returns validation error","Block hash not found on the specified chain — returns not-found or null result","Unsupported chain name provided — schema enum validation failure","Payment failure or insufficient USDC balance — x402 payment required error","Network timeout or node unavailability on the target chain — upstream error"],"whenToPreferThis":"Choose this endpoint when you already know a block's 32-byte hash and need its header data (timestamp, miner, gas, parent hash, etc.) on any of ten major EVM chains without running your own node. It is ideal for agents performing blockchain audits, cross-chain verification, or transaction provenance lookups where the block hash is the known anchor point rather than the block number.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:55:40.973Z","isFirstParty":false,"canonicalSlug":"evm-block-header-by-block-hash-382b13ef"}