# TzKT Contracts List API

> TzKT Contracts List 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 filtered, paginated list of Tezos smart contracts from the TzKT blockchain indexer

## Facts

- Endpoint: GET https://x402.tzkt.io/v1/contracts
- 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-contracts-list-api-d4558bfc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5KMSl0oSDOaHqvedi4of-

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-contracts-list-api-d4558bfc
```

Example prompt: Show me the top 50 Tezos smart contracts sorted by balance descending, only return the address and balance fields, and filter to contracts with a balance greater than 1000000 mutez.

## When to prefer this

Use this endpoint when you need to enumerate, filter, or paginate through Tezos smart contracts at the network level without requiring authentication. It is ideal for blockchain analytics, DeFi research, contract discovery, and on-chain auditing tasks. Prefer this over individual contract lookup endpoints when you need a list view rather than details about a single known contract address.

## Known failure modes

- Invalid 'kind' enum value returns empty results or 400 error
- Limit exceeding 10000 returns a validation error
- Malformed balance filter syntax (missing operator suffix) returns 400
- Network congestion may increase response latency
- Requesting too many fields via 'select' may cause partial data return

## 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 array of Tezos smart contract objects. Each object includes contract address, kind (e.g. delegator, smart_contract), balance in mutez, and other on-chain metadata depending on the 'select' fields specified. Results are paginated and sorted per request parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "kind": {
   "enum": [
    "smart_contract",
    "delegator_contract"
   ],
   "type": "string",
   "description": "Contract kind filter"
  },
  "sort": {
   "type": "string",
   "description": "Sorting field and direction"
  },
  "limit": {
   "type": "integer",
   "description": "Max items to return (1-10000)"
  },
  "offset": {
   "type": "integer",
   "description": "Pagination offset"
  },
  "select": {
   "type": "string",
   "description": "Comma-separated list of fields to return"
  },
  "balance": {
   "type": "string",
   "description": "Filter by balance in mutez (supports .eq .gt .lt)"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

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