# TzKT Delegates List API

> TzKT Delegates 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 paginated list of Tezos delegates (bakers) with optional filtering by active status, balance, and field selection

## Facts

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

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-delegates-list-api-5ddd23b0
```

Example prompt: Can you pull me the top 50 active Tezos delegates sorted by balance descending, and just return their address and balance fields?

## When to prefer this

Use this endpoint when you need to enumerate, filter, or paginate through Tezos network delegates/bakers specifically. Prefer this over generic blockchain explorers when you need structured, machine-readable delegate data with flexible filtering by balance or active status. The no-API-key requirement and x402 micropayment model make it suitable for automated agent workflows that need on-demand Tezos baker data without registration overhead.

## Known failure modes

- Invalid filter syntax for balance field returns 400 Bad Request
- Limit value outside 1-10000 range returns validation error
- Unknown field names in select parameter may return empty or error response
- Network timeouts on very large result sets
- Payment failure via x402 protocol blocks request before reaching the API

## 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 delegate objects from the Tezos blockchain, each containing fields such as address, balance, active status, staking balance, delegators count, and other baker metadata depending on the selected fields. The array respects the requested limit and offset for pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "type": "string",
   "description": "Sorting field and direction"
  },
  "limit": {
   "type": "integer",
   "description": "Max items to return (1-10000)"
  },
  "active": {
   "type": "boolean",
   "description": "Filter by active status"
  },
  "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-delegates-list-api-5ddd23b0/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)