# TzKT Token Transfers Count

> TzKT Token Transfers Count 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).

Returns the total count of token transfer operations on the Tezos blockchain, optionally filtered by token contract address.

## Facts

- Endpoint: GET https://x402.tzkt.io/v1/tokens/transfers/count
- 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-token-transfers-count-289ca6b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZEnVHL75-zxTEJvQcVM_Q

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-token-transfers-count-289ca6b8
```

Example prompt: How many token transfers have occurred for the Tezos contract KT1RJ6PbjHpwc3M5rw5s2Nbmefwbuwbdxton on TzKT?

## When to prefer this

Use this endpoint when you need a fast, lightweight count of Tezos token transfers without fetching full transfer records. Ideal for dashboards, analytics, and activity monitoring where only the aggregate number matters, not the individual transfer details. Prefer this over fetching full transfer lists when you only need the total figure to save bandwidth and cost.

## Known failure modes

- Invalid contract address format returns an error or zero count
- Network timeouts if the Tezos node is temporarily unreachable
- Payment failure if the x402 USDC micropayment of $0.002 is not properly submitted
- Returns 0 for a valid but newly deployed contract with no transfers yet

## 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 single integer representing the total count of token transfer operations matching the given filter. If a contract address is provided, the count is scoped to that contract; otherwise it reflects the global total across all Tezos token transfers.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "contract": {
   "type": "string",
   "description": "Filter by token contract address"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "integer"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tzkt-token-transfers-count-289ca6b8/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)
