# TzKT Tezos Contract Lookup API

> TzKT Tezos Contract Lookup 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-13).

Retrieves detailed information about a specific Tezos smart contract by its on-chain address via the TzKT blockchain indexer.

## Facts

- Endpoint: POST https://x402.tzkt.io/v1/contracts/%7Baddress%7D
- 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-tezos-contract-lookup-api-d1d74acb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_D-HZCXnFH3bLvwnqfacUP

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-tezos-contract-lookup-api-d1d74acb -d '<json body>'
```

Example prompt: Can you pull up the full details for the Tezos smart contract at address KT1RJ6PbjHpwc3M5rw5s2Nbmefwbuwbdxton — I want to see its storage, entrypoints, balance, and who originated it.

## When to prefer this

Use this endpoint when you need structured, indexed data about a specific Tezos smart contract without running your own Tezos node. It is superior to raw RPC calls because it provides enriched metadata, human-readable entrypoints, and historical context. Prefer it over generic blockchain explorers when you need programmatic access with no API key and per-call micropayment pricing via the x402 protocol.

## Known failure modes

- Invalid or malformed Tezos address returns 400 Bad Request
- Address exists but is an implicit account (tz1/tz2/tz3), not a contract — returns 404 or empty
- Contract exists but has not been indexed yet — may return stale or incomplete data
- Network congestion or TzKT indexer lag may return outdated storage snapshot
- Payment of 0.002 USDC via x402 protocol fails — returns 402 Payment Required

## 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 containing the contract's on-chain details including its address, balance in mutez, manager/owner, origination operation hash, originated block level and timestamp, contract type, entrypoints, current storage value, code, and any associated metadata (TZIP-16 off-chain views, token metadata if applicable).

## More

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