{"uid":"cap_QbWqTSglGPgnpN7TgLyJ2","slug":"tzkt-bigmap-keys-lookup-08d5ac61","name":"TzKT Bigmap 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/keys","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_8OeRyr-qxanuhj5McMctR","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 keys stored within a specific Tezos smart contract bigmap by its numeric ID","exampleAgentPrompt":"Can you pull all the active keys from Tezos bigmap ID 1234 on TzKT so I can see what's stored in that contract's ledger?","exampleUseCases":[{"title":"Inspect FA2 token ledger entries","prompt":"I need to see all the key-value entries in the FA2 token ledger bigmap — its bigmap ID is 5678 on Tezos. Can you fetch the active keys from TzKT so I can audit who holds balances?"},{"title":"Monitor DAO governance bigmap state","prompt":"Pull the current keys from Tezos bigmap 9101 for me — that's the governance proposal storage for a DAO contract — I want to see all the active proposal entries right now."},{"title":"Debug smart contract storage during development","prompt":"I'm developing a Tezos contract and I need to inspect bigmap 3322 to verify that the keys my contract wrote during the last operation actually landed correctly — can you fetch those keys from TzKT?"}],"resultDescription":"Returns a list of bigmap key objects for the specified bigmap ID, each containing the key hash, key value (in Michelson or decoded form), associated value data, active/inactive status, and block-level metadata indicating when the key was first and last updated.","failureModes":["Invalid or non-existent bigmap ID returns a 404 or empty result","Malformed filter parameters may result in a 400 Bad Request","Very large bigmaps with thousands of keys require pagination; missing pagination parameters may yield incomplete results","Payment failure or insufficient USDC balance via x402 protocol blocks the request","Rate limiting may apply if payment is not correctly attached"],"whenToPreferThis":"Use this endpoint when you need to enumerate or search the keys of a specific Tezos bigmap by its numeric ID, particularly for auditing smart contract storage, inspecting token ledger entries, or indexing on-chain data. Prefer TzKT over raw RPC node queries because it offers indexed, fast, and filterable access without running your own node. Choose this over the TzKT accounts or operations endpoints when your focus is specifically on bigmap storage contents rather than transaction history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:51:23.185Z","isFirstParty":false}