# TzKT Accounts List API

> TzKT Accounts 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-13).

Fetches a paginated, filterable list of Tezos blockchain accounts including users, delegates, contracts, and rollups with their balances and metadata.

## Facts

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

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-accounts-list-api-5d2b1deb
```

Example prompt: Show me the top 50 Tezos delegate accounts sorted by balance descending — I want to see who the biggest bakers are on the network right now.

## When to prefer this

Use this endpoint when you need to enumerate, filter, or paginate through Tezos blockchain accounts by type, balance, delegate, or staked status. It is the best choice for bulk account discovery without requiring authentication or an API key. Prefer this over single-account lookup endpoints when you need multiple accounts matching criteria, or over block/operation endpoints when the target entity is an account.

## Known failure modes

- Invalid account type enum value returns 400 Bad Request
- Balance filter with malformed operator syntax returns 400
- Limit exceeding 10,000 returns validation error
- Offset beyond total account count returns empty array
- Network or indexer downtime returns 5xx error
- Malformed select field list causes partial or error response

## 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 account objects, each containing fields such as address, account type (user, delegate, contract, rollup), balance in mutez, delegate address, staked status, and other account-level metadata. The number of results is controlled by the limit parameter (max 10,000).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "type": "string",
   "description": "Sorting field and direction"
  },
  "type": {
   "enum": [
    "user",
    "delegate",
    "contract",
    "rollup"
   ],
   "type": "string",
   "description": "Account type filter (user|delegate|contract|rollup)"
  },
  "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"
  },
  "staked": {
   "type": "boolean",
   "description": "Filter by staked status"
  },
  "balance": {
   "type": "string",
   "description": "Filter by balance in mutez (supports .eq .gt .lt)"
  },
  "delegate": {
   "type": "string",
   "description": "Filter by delegate address"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

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