# TzKT Bigmap Keys Lookup

> TzKT Bigmap Keys Lookup is a paid API for AI agents from x402.tzkt.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Retrieves keys stored within a specific Tezos smart contract bigmap by its numeric ID

## Facts

- Endpoint: POST https://x402.tzkt.io/v1/bigmaps/%7Bid%7D/keys
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tzkt-bigmap-keys-lookup-08d5ac61
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QbWqTSglGPgnpN7TgLyJ2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tzkt-bigmap-keys-lookup-08d5ac61 -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tzkt-bigmap-keys-lookup-08d5ac61/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tzkt.io](https://www.zero.xyz/host/x402.tzkt.io/llms.txt)