# TzKT Tokens List API

> TzKT Tokens 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 tokens indexed on-chain, filterable by contract, token ID, and token standard

## Facts

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

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-tokens-list-api-ecd7e892
```

Example prompt: Can you pull me a list of up to 50 FA2 tokens from the Tezos contract KT1RJ6PbjHpwc3M5rw5s2Nbmefwbuwbdxton, sorted by tokenId?

## When to prefer this

Use this endpoint when you need to enumerate, search, or filter tokens on the Tezos blockchain by contract, token ID, or standard without needing to authenticate or obtain an API key. Prefer it over generic blockchain explorers when you need structured, machine-readable token data with flexible pagination and field selection.

## Known failure modes

- Invalid contract address format returns an error or empty array
- Requesting a limit above 10000 may be rejected or capped
- Invalid sort field name returns an error
- Payment of 0.002 USDC not fulfilled triggers 402 Payment Required
- Nonexistent token ID filter returns empty array

## 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 token objects, each containing fields such as contract address, token ID, token standard (FA1.2 or FA2), and associated metadata. The response is paginated and field-selectable based on query parameters.

## 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)"
  },
  "offset": {
   "type": "integer",
   "description": "Pagination offset"
  },
  "select": {
   "type": "string",
   "description": "Comma-separated list of fields to return"
  },
  "tokenId": {
   "type": "string",
   "description": "Filter by token ID"
  },
  "contract": {
   "type": "string",
   "description": "Filter by contract address"
  },
  "standard": {
   "enum": [
    "fa1.2",
    "fa2"
   ],
   "type": "string",
   "description": "Filter by token standard"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

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