{"uid":"cap_KmmC_whPVZ0NC7NkgDKrh","slug":"xerxes-ethereum-eth-getblockbynumber-d4654c19","name":"Xerxes Ethereum eth_getBlockByNumber","description":"Returns a block by its number (or 'latest') from Ethereum: hash, number, timestamp, gas used, gas limit, miner, transactions list. Query: block (a block number, or 'latest').","url":"https://ari001.tailb4ac3a.ts.net/v1/ventures/ethereum_contract_abi_service/eth_getblockbynumber?utm_source=zero.xyz","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"},"queryParams":{"type":"object","properties":{"block":{"type":"string","pattern":"^(latest|[0-9]{1,12})$","description":"a block number, or 'latest'"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean"},"chain":{"type":"string"},"error":{"type":"string","description":"present when ok is false"},"method":{"type":"string"},"result":{"type":"object","description":"the node's JSON-RPC object, as returned"},"service":{"type":"string"}}}}}}},"responseSchema":null,"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_iJz-eGUWxK-R9Y4ZzAFwo","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":"Fetches Ethereum block metadata (hash, number, timestamp, gas used, gas limit, miner, transactions) by block number or 'latest'","exampleAgentPrompt":"What are the details of Ethereum block 21000000 — hash, timestamp, gas used, miner, and list of transactions?","exampleUseCases":[{"title":"Inspect latest Ethereum block","prompt":"Pull the latest Ethereum block and tell me the block number, timestamp, gas used, miner address, and how many transactions are in it."},{"title":"Audit specific block by number","prompt":"I need the full details for Ethereum block 20500000 — hash, miner, gas limit, gas used, and the transaction list."},{"title":"Verify block timestamp for record-keeping","prompt":"What was the exact timestamp and miner for Ethereum block 19750000? I need it to verify when an on-chain event occurred."}],"resultDescription":"Returns a JSON object with ok (boolean), chain, method, service, and a result object containing the Ethereum block's hash, number, timestamp, gas used, gas limit, miner address, and array of transaction hashes. If ok is false, an error field is present with a description.","failureModes":["Invalid block number format returns an error with ok: false","Block number does not exist yet (future block) returns an error","Network timeout from the Ethereum node results in a service error","Missing 'block' query param defaults to 'latest' but malformed patterns are rejected by schema validation"],"whenToPreferThis":"Use this endpoint when you need to retrieve Ethereum block-level metadata — including hash, miner, gas metrics, timestamp, and transaction list — by a specific block number or the chain head. Prefer it over transaction-level endpoints when the query is block-scoped rather than address- or transaction-scoped. It is ideal for on-chain event verification, block timing audits, and pipeline triggers keyed to block production.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:30:10.270Z","isFirstParty":false,"canonicalSlug":"xerxes-ethereum-eth-getblockbynumber-d4654c19"}