{"uid":"cap_okYpgs6-FzaHJTecVgs7Q","slug":"tzkt-api-tezos-blockchain-head-be3f8fcd","name":"TzKT API – Tezos Blockchain Head","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/head","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"quote":{"enum":["Btc","Eur","Usd","Cny","Jpy","Krw","Eth","Gbp"],"type":"string","description":"Quote currency for balance fields"}}},"responseSchema":{"type":"object","properties":{"hash":{"type":"string"},"level":{"type":"integer"},"protocol":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"votingEpoch":{"type":"integer"}}},"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_ienG5X202PuDTDos10stu","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":"Returns the current head block information for the Tezos blockchain, including block hash, level, protocol, timestamp, and voting epoch.","exampleAgentPrompt":"What's the current Tezos blockchain head — give me the latest block level, hash, and timestamp?","exampleUseCases":[{"title":"Real-time Tezos chain sync check","prompt":"Is the Tezos network up to date? Tell me the latest block level and timestamp so I can confirm my indexer is in sync."},{"title":"Monitor Tezos protocol upgrades","prompt":"What protocol is the Tezos blockchain currently running and what voting epoch are we in?"},{"title":"Blockchain explorer dashboard feed","prompt":"Fetch the current Tezos head block details — I need the hash, level, and timestamp to display on my blockchain dashboard."}],"resultDescription":"Returns a JSON object with the current Tezos blockchain head: block hash (string), block level (integer), active protocol identifier (string), block timestamp (ISO 8601 datetime), and current voting epoch (integer).","failureModes":["Network or upstream TzKT service unavailability returning 5xx errors","Payment failure or insufficient USDC balance triggering 402 response","Invalid quote currency parameter returning 400 bad request","Rate limiting if called excessively in short timeframes"],"whenToPreferThis":"Choose this endpoint when you need real-time, lightweight Tezos chain head data without authentication overhead. Ideal for monitoring scripts, dashboards, or sync checks that just need the latest block level, hash, and protocol. Prefer TzKT over other Tezos indexers for its comprehensive coverage and no-signup access model.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:56.288Z","isFirstParty":false}