{"uid":"cap_nuye_62-QLZgyVTLxjgh6","slug":"tzkt-bigmap-historical-keys-lookup-f9f10262","name":"TzKT Bigmap Historical Keys Lookup","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/bigmaps/%7Bid%7D/historical_keys/%7Blevel%7D","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"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_GgO8C_hpj441qGTYFm2-S","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 the historical state of keys in a Tezos smart contract bigmap at a specific block level","exampleAgentPrompt":"Can you pull the historical keys from Tezos bigmap ID 1234 as they existed at block level 3500000?","exampleUseCases":[{"title":"Audit smart contract storage at past block","prompt":"I need to see what keys were stored in Tezos bigmap 511 at block level 2800000 — can you pull a snapshot of that bigmap's historical state for me?"},{"title":"DeFi protocol liquidity state reconstruction","prompt":"What did the liquidity positions look like in bigmap 789 at block 3100000 on Tezos? I'm trying to reconstruct the state of a DeFi pool at that point."},{"title":"Verify on-chain data before a known event","prompt":"Can you check what keys existed in Tezos bigmap 42 right before block level 2950000? I want to compare the bigmap state just before a governance vote was executed."}],"resultDescription":"Returns a list of bigmap key entries as they existed at the specified block level, including key hashes, key values, and associated data stored in the bigmap at that historical point on the Tezos blockchain.","failureModes":["Invalid bigmap ID returns 404 not found","Block level out of range or before bigmap creation returns empty result or error","Malformed request body returns 400 bad request","Payment failure via x402 protocol results in 402 response and no data returned","Very large bigmaps may require pagination parameters to avoid timeouts"],"whenToPreferThis":"Use this endpoint when you need point-in-time historical state of a Tezos smart contract bigmap — specifically when reconstructing past contract storage, auditing on-chain data at a specific block, or analyzing state changes over time. Prefer this over current-state bigmap endpoints when the historical snapshot is what matters. The no-API-key requirement and x402 micropayment model makes it suitable for automated agent workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:30:31.508Z","isFirstParty":false}