# TzKT Tezos Account Lookup API

> TzKT Tezos Account 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 on-chain account information for a given Tezos address, including balance, transaction history, and account metadata.

## Facts

- Endpoint: POST https://x402.tzkt.io/v1/accounts/%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-account-lookup-api-cfa1a798
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R87zfY3BEm_YNSArqMlFM

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-account-lookup-api-cfa1a798 -d '<json body>'
```

Example prompt: Can you pull up the on-chain account details for the Tezos address tz1VSUr8wwNhLAzempoch5d6hLRiTh8Cjcjb — I want to see the balance, delegate, and when it was last active?

## When to prefer this

Choose this endpoint when you need authoritative, indexed Tezos blockchain account data without managing your own node or RPC infrastructure. It is ideal for agents performing wallet lookups, balance checks, delegation verification, or contract identification on the Tezos network. Prefer it over raw Tezos RPC calls when you need enriched metadata (activity timestamps, transaction counts, delegate info) in a single request. No API key or signup is required — only a micropayment via the x402 protocol.

## Known failure modes

- Invalid or malformed Tezos address returns a 400 or empty result
- Address has never been active on-chain (ghost account) returns minimal or null fields
- Network congestion may cause slower-than-usual response times
- Payment failure via x402 protocol results in 402 Payment Required before data is returned
- Address with very high transaction volume may have truncated history in summary fields

## 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 describing the Tezos account: account type (user, delegate, contract, ghost, etc.), XTZ balance, number of transactions, current delegate, revealed public key, first and last activity block levels and timestamps, and additional contract-specific fields if applicable.

## More

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