{"uid":"cap_-JutGB-K4yd53KiIzfHlF","slug":"tzkt-block-lookup-by-hash-272b5d71","name":"TzKT Block Lookup by Hash","description":"TzKT is a comprehensive Tezos blockchain indexer API. Access blocks, operations, accounts, contracts, bigmaps, delegates, tokens and network stats through a fast REST API. No signup or API key required.","url":"https://x402.tzkt.io/v1/blocks/%7Bhash%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"quote":{"type":"string","description":"Quote currency"},"operations":{"type":"boolean","description":"Include all operations in response"}}},"responseSchema":{"type":"object","properties":{"fees":{"type":"integer"},"hash":{"type":"string"},"baker":{"type":"object"},"level":{"type":"integer"},"proto":{"type":"integer"},"reward":{"type":"integer"},"priority":{"type":"integer"},"timestamp":{"type":"string","format":"date-time"}}},"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_cTs_Yxh-Ji_0aN5Kp0XOf","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":"Retrieves detailed metadata for a specific Tezos block identified by its hash, including fees, baker, reward, and optional operations.","exampleAgentPrompt":"Can you pull up the details for Tezos block BLockHashABC123 — I want to see the baker, fees, reward, and timestamp, and include all the operations in the response?","exampleUseCases":[{"title":"Verify Tezos block finality","prompt":"I need to confirm that Tezos block BLockXYZ987 made it onto the chain — can you fetch its details and tell me the level, timestamp, and who baked it?"},{"title":"Audit block rewards and fees","prompt":"Pull up the full details for Tezos block BLockABC456, including all operations, so I can audit the baker rewards and fees collected in that block."},{"title":"Track protocol version at a block","prompt":"What protocol version and priority was Tezos block BLockDEF789 produced at? I'm checking for a protocol upgrade cutoff."}],"resultDescription":"Returns a JSON object containing the block's hash, level, protocol version (proto), baker object, fees (integer), reward (integer), priority (integer), and ISO 8601 timestamp. If the operations flag is set, all operations included in the block are also returned. Quote currency can be specified for fiat-equivalent valuations.","failureModes":["Block hash not found — returns 404 if the hash does not correspond to any known block","Invalid hash format — malformed hash strings may return 400 Bad Request","Network or gateway errors from the x402 payment layer — payment may fail before the request reaches TzKT","Rate limiting or payment failure — if the $0.002 USDC micropayment is not processed, the request is rejected"],"whenToPreferThis":"Use this endpoint when you have a specific Tezos block hash and need authoritative, indexed metadata about that block (baker, fees, reward, operations) without running your own Tezos node. It requires no API key and charges a small per-call micropayment via x402. Prefer this over general Tezos RPC nodes when you want structured, pre-indexed data with optional quote currency support and don't want to parse raw node output.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:30:34.522Z","isFirstParty":false}