# TzKT Tezos Transactions API

> TzKT Tezos Transactions 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).

Retrieves a paginated list of Tezos blockchain transactions with flexible filtering by sender, target, amount, block level, timestamp, and status.

## Facts

- Endpoint: GET https://x402.tzkt.io/v1/operations/transactions
- 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-tezos-transactions-api-b8ee4d6a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7W2Wfp-B6en61Mg5vwPrq

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-tezos-transactions-api-b8ee4d6a
```

Example prompt: Pull me the last 50 transactions sent from tz1VSUr8wwNhLAzempoch5d6hLRiTh8Cjcjb on the Tezos blockchain, sorted by most recent first and only return the hash, amount, sender, target, and timestamp fields.

## When to prefer this

Use this endpoint when you need to query, filter, or paginate Tezos blockchain transaction (transfer) operations with fine-grained control over sender, target, amount, and time range. It is ideal for wallet history lookups, smart contract interaction audits, or on-chain analytics on the Tezos network. Prefer this over generic block explorers when you need structured JSON output for programmatic processing without requiring an API key.

## Known failure modes

- Invalid address format returns an error or empty array
- Unsupported filter syntax for range operators returns 400
- Limit exceeding 10000 returns a validation error
- Payment failure via x402 results in 402 before query executes
- Requesting non-existent fields via select returns partial or empty results

## 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 an array of transaction objects from the Tezos blockchain, each containing fields such as operation hash, block level, timestamp, sender address, target address, amount in mutez, fees, status (applied/failed/backtracked), and optional quote currency conversions. The number of results is bounded by the limit parameter (up to 10,000).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "type": "string",
   "description": "Sorting field and direction"
  },
  "anyof": {
   "type": "string",
   "description": "Match any of the specified account fields, e.g. anyof.sender.target=tz1..."
  },
  "level": {
   "type": "string",
   "description": "Filter by block level (supports .eq .gt .lt)"
  },
  "limit": {
   "type": "integer",
   "description": "Max items to return (1-10000)"
  },
  "quote": {
   "type": "string",
   "description": "Quote currency"
  },
  "amount": {
   "type": "string",
   "description": "Filter by amount in mutez (supports .eq .gt .lt)"
  },
  "offset": {
   "type": "integer",
   "description": "Pagination offset"
  },
  "select": {
   "type": "string",
   "description": "Comma-separated list of fields to return"
  },
  "sender": {
   "type": "string",
   "description": "Filter by sender address"
  },
  "status": {
   "enum": [
    "applied",
    "failed",
    "backtracked",
    "skipped"
   ],
   "type": "string",
   "description": "Filter by status"
  },
  "target": {
   "type": "string",
   "description": "Filter by target address"
  },
  "initiator": {
   "type": "string",
   "description": "Filter by initiator address"
  },
  "timestamp": {
   "type": "string",
   "description": "Filter by timestamp (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-tezos-transactions-api-b8ee4d6a/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)