# TzKT Contract Storage Reader

> TzKT Contract Storage Reader 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 the current on-chain storage of a Tezos smart contract by its address

## Facts

- Endpoint: POST https://x402.tzkt.io/v1/contracts/%7Baddress%7D/storage
- 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-contract-storage-reader-e0fcd4b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VUsdQwfP9WeLloIfwj35q

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-contract-storage-reader-e0fcd4b8 -d '<json body>'
```

Example prompt: Can you fetch the current on-chain storage for the Tezos contract at KT1RJ6PbjHpwc3M5rw5s2Nbmefwbuwbdxton so I can see what state it's holding right now?

## When to prefer this

Use this endpoint when you need the full decoded current storage of a Tezos smart contract indexed by TzKT, especially when you want a structured JSON view without writing RPC calls to a Tezos node directly. Prefer this over raw Tezos node RPC when you want human-readable decoded Michelson storage rather than raw binary, and when you need no API key overhead. Ideal for agents inspecting DeFi protocols, NFT contracts, DAO governance contracts, or any KT1 address on Tezos mainnet.

## Known failure modes

- Invalid or non-existent contract address returns a 404 error
- Contract address that is not a smart contract (e.g. an implicit account) returns an error or empty response
- Malformed address format causes a 400 bad request
- Network or indexer lag may mean storage is slightly behind chain head
- Payment failure via x402 protocol results in 402 response and no data 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 a JSON object representing the current decoded storage of the specified Tezos smart contract, including all top-level fields such as bigmap IDs, addresses, nat/int values, maps, and nested records as they exist on-chain at the latest indexed block.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tzkt-contract-storage-reader-e0fcd4b8/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)