{"uid":"cap_xelQVCFlj0nJG3Lbhwt9h","slug":"blockscout-block-details-by-chain-24224ad7","name":"Blockscout Block Details by Chain","description":"Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data","url":"https://api.blockscout.com/%7Bchain_id%7D/api/v2/blocks/%7Bblock_hash_or_number_param%7D","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","properties":{"chain_id":{"type":"string"},"block_hash_or_number_param":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"hash":"string","size":0,"type":"string","miner":{},"nonce":"string","height":0,"rewards":[{"type":"string","reward":"string"}],"arbitrum":{"status":"string","send_root":"string","send_count":0,"batch_number":0,"l1_block_number":0,"delayed_messages":0,"batch_data_container":"string","commitment_transaction":{"hash":"string","status":"string","timestamp":"string"},"confirmation_transaction":{"hash":"string","status":"string","timestamp":"string"}},"gas_used":"string","gas_limit":"string","timestamp":"string","burnt_fees":"string","difficulty":"string","parent_hash":"string","priority_fee":"string","uncles_hashes":[{"hash":"string"}],"base_fee_per_gas":"string","total_difficulty":"string","transaction_fees":"string","is_pending_update":true,"withdrawals_count":0,"transactions_count":0,"gas_used_percentage":0,"burnt_fees_percentage":0,"gas_target_percentage":0,"internal_transactions_count":0}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_c9UKyVTnqsHdTjkdpCF1L","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieve detailed metadata for a specific block by hash or number on a given blockchain network via Blockscout's multichain explorer API","exampleAgentPrompt":"Pull up the full details for block number 19500000 on Ethereum using Blockscout — I want to see the miner, gas usage, transaction count, and any block rewards.","exampleUseCases":[{"title":"Audit block gas consumption on Ethereum","prompt":"Can you look up block 20000000 on Ethereum mainnet and tell me how much gas was used, the gas limit, and what percentage of the gas target was hit?"},{"title":"Verify block finality on Arbitrum","prompt":"I need to check the status and commitment transaction details for block hash 0xabc123... on Arbitrum — can you pull that from Blockscout and tell me if it's been confirmed on L1?"},{"title":"Investigate miner rewards for a block","prompt":"Who mined block 18999999 on Ethereum and what rewards did they receive? Grab the block details from Blockscout for me."}],"resultDescription":"Returns a JSON object with comprehensive block metadata including: block hash, height, size, type, miner info, nonce, timestamp, gas used and limit, burnt fees, base fee per gas, difficulty, total difficulty, parent hash, priority fee, transaction fees, transaction count, internal transaction count, withdrawals count, uncle hashes, gas used/target/burnt percentages, block rewards breakdown, and chain-specific fields (e.g. Arbitrum batch/commitment data).","failureModes":["Invalid chain_id returns 404 or empty response","Block hash or number not found on the specified chain returns 404","Malformed block hash format returns 400 bad request","Chain not supported by Blockscout returns error","Payment not included or insufficient USDC balance causes 402 Payment Required","Rate limiting or network timeout causes 5xx error"],"whenToPreferThis":"Use this endpoint when you need detailed, structured block-level data (gas, miner, rewards, transaction counts, timestamps) for a specific block on a specific chain. Prefer this over generic RPC calls when you need Blockscout's enriched data model including burnt fees, priority fees, and chain-specific metadata like Arbitrum batch info. Ideal for multichain scenarios where you need a unified API across networks rather than chain-native RPCs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T00:53:34.640Z","isFirstParty":false}