# TzKT Bigmaps API

> TzKT Bigmaps API 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-14).

Retrieves a paginated list of Tezos smart contract bigmaps, filterable by contract address, storage path, and active status

## Facts

- Endpoint: GET https://x402.tzkt.io/v1/bigmaps
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tzkt-bigmaps-api-adf7808c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5S95Dd3Ceg-_8pPC1YaCY

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-bigmaps-api-adf7808c
```

Example prompt: Show me the first 50 active bigmaps for Tezos contract KT1RJ6PbjHpwc3M5bw5AVoXHjsWjSWRFGFXK, sorted by ID.

## When to prefer this

Use this endpoint when you need to enumerate or filter bigmaps across Tezos smart contracts without requiring an API key or signup. Prefer it over direct Tezos node RPC calls when you want indexed, fast, human-readable bigmap metadata with rich filtering by contract, path, and status. If you need individual bigmap key lookups or bigmap values rather than a list of bigmaps, a different TzKT endpoint may be more appropriate.

## Known failure modes

- Invalid contract address format returns empty array or 400 error
- Limit value outside 1–10000 range may return a validation error
- Unknown or misspelled storage path returns empty results
- Offset beyond total record count returns empty array
- Payment failure (x402 protocol) blocks the request before data is returned

## 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 an array of bigmap objects, each describing a Tezos smart contract bigmap including its ID, contract address, storage path, active/inactive status, and associated metadata such as key and value types.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "path": {
   "type": "string",
   "description": "Filter by storage path"
  },
  "sort": {
   "type": "string",
   "description": "Sorting field and direction"
  },
  "limit": {
   "type": "integer",
   "description": "Max items to return (1-10000)"
  },
  "active": {
   "type": "boolean",
   "description": "Filter by active status"
  },
  "offset": {
   "type": "integer",
   "description": "Pagination offset"
  },
  "contract": {
   "type": "string",
   "description": "Filter by contract address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "array",
 "items": {
  "type": "object"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tzkt-bigmaps-api-adf7808c/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)