{"uid":"cap_Dq-cZ7kDqCigAOTaN7aG-","slug":"tzkt-bigmap-key-lookup-416daa86","name":"TzKT Bigmap Key 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/%7Bkey%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_a0s1OPYqfFJeArMZcLha4","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 value stored at a specific key within a Tezos smart contract bigmap by bigmap ID and key","exampleAgentPrompt":"Look up the value stored at key 'tz1abc123...' in bigmap number 4521 on the Tezos blockchain using TzKT.","exampleUseCases":[{"title":"Check token ledger balance","prompt":"Look up whether address tz1XYZ... owns any tokens by checking bigmap 12345 for that key in TzKT — I want to see the raw balance entry."},{"title":"Inspect FA2 contract allowance","prompt":"Query bigmap 8901 for the key corresponding to operator tz1ABC... on the Tezos mainnet — I need to see if the allowance entry exists and what it contains."},{"title":"Read on-chain DAO proposal vote","prompt":"Fetch the stored value for proposal key 'prop_007' from bigmap 3344 on Tezos so I can see the current vote tallies for that governance proposal."}],"resultDescription":"Returns a JSON object containing the bigmap key entry, including the key hash, the raw key, the decoded key value, whether the key is active, the first and last level at which the entry appeared, and associated metadata such as timestamp and update count.","failureModes":["Bigmap ID not found — returns 404 if the specified bigmap does not exist","Key not found within the bigmap — returns 404 if the key has never been set or was removed","Invalid key format — malformed key expression may result in a 400 bad request","Network timeout or rate limiting under high load","Key exists but was previously removed (active=false returned)"],"whenToPreferThis":"Use this endpoint when you need to read the exact value stored at a known key within a specific Tezos smart contract bigmap. It is ideal for inspecting on-chain contract storage such as FA2 ledger balances, DAO votes, or allowance maps without needing to index the entire contract. Prefer this over scanning all bigmap keys when the key is already known.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:52:16.313Z","isFirstParty":false}